@radix-ng/primitives 0.35.0 → 0.36.0

package/core/index.d.ts

@@ -1,7 +1,9 @@
 export * from './src/accessor/provide-value-accessor';
 export * from './src/auto-focus.directive';
+export * from './src/clamp';
 export * from './src/document';
 export * from './src/focus-initial.directive';
+export * from './src/getActiveElement';
 export * from './src/id-generator';
 export * from './src/inject-ng-control';
 export * from './src/is-client';

package/core/src/clamp.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The `clamp` function restricts a number within a specified range by returning the value itself if it
+ * falls within the range, or the closest boundary value if it exceeds the range.
+ * @param {number} value - The `value` parameter represents the number that you want to clamp within
+ * the specified range defined by `min` and `max` values.
+ * @param {number} min - If the `value` parameter is less than the `min` value, the
+ * function will return the `min` value.
+ * @param {number} max - If the `value` parameter is greater than the `max` value,
+ * the function will return `max`.
+ * @returns The `clamp` function returns the value of `value` constrained within the range defined by
+ * `min` and `max`.
+ */
+export declare function clamp(value: number, min?: number, max?: number): number;
+/**
+ * The function `roundToStepPrecision` rounds a number to a specified precision step.
+ * @param {number} value - The `value` parameter is the number that you want to round to a specific
+ * precision based on the `step` parameter.
+ * @param {number} step - The `step` parameter in the `roundToStepPrecision` function represents the
+ * interval at which you want to round the `value`. For example, if `step` is 0.5, the `value` will be
+ * rounded to the nearest half.
+ * @returns the `roundedValue` after rounding it to the precision specified by the `step`.
+ */
+export declare function roundToStepPrecision(value: number, step: number): number;
+/**
+ * The function `snapValueToStep` snaps a given value to the nearest step within a specified range.
+ * @param {number} value - The `value` parameter represents the number that you want to snap to the
+ * nearest step value.
+ * @param {number | undefined} min - The `min` parameter represents the minimum value that the `value`
+ * should be snapped to. If `value` is less than `min`, it will be snapped to `min`. If `min` is not
+ * provided (undefined), then the snapping will not consider a minimum value.
+ * @param {number | undefined} max - The `max` parameter represents the maximum value that the `value`
+ * should be snapped to. It ensures that the snapped value does not exceed this maximum value.
+ * @param {number} step - The `step` parameter in the `snapValueToStep` function represents the
+ * interval at which the `value` should be snapped to. It determines the granularity of the snapping
+ * operation. For example, if `step` is 5, the `value` will be snapped to the nearest multiple of
+ * @returns a number that has been snapped to the nearest step value within the specified range of minimum and maximum values.
+ */
+export declare function snapValueToStep(value: number, min: number | undefined, max: number | undefined, step: number): number;

package/core/src/getActiveElement.d.ts

@@ -0,0 +1 @@
+export declare function getActiveElement(): Element | null;

package/date-field/index.d.ts

@@ -1,2 +1,11 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./src/date-field-root.directive";
+import * as i2 from "./src/date-field-input.directive";
+export * from './src/date-field-context.token';
 export * from './src/date-field-input.directive';
 export * from './src/date-field-root.directive';
+export declare class RdxDateFieldModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<RdxDateFieldModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<RdxDateFieldModule, never, [typeof i1.RdxDateFieldRootDirective, typeof i2.RdxDateFieldInputDirective], [typeof i1.RdxDateFieldRootDirective, typeof i2.RdxDateFieldInputDirective]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<RdxDateFieldModule>;
+}

package/fesm2022/radix-ng-primitives-core.mjs

@@ -101,6 +101,76 @@ function getRequestAnimationFrame() {
 // Get the requestAnimationFrame function or its polyfill.
 const reqAnimationFrame = getRequestAnimationFrame();
 
+/**
+ * The `clamp` function restricts a number within a specified range by returning the value itself if it
+ * falls within the range, or the closest boundary value if it exceeds the range.
+ * @param {number} value - The `value` parameter represents the number that you want to clamp within
+ * the specified range defined by `min` and `max` values.
+ * @param {number} min - If the `value` parameter is less than the `min` value, the
+ * function will return the `min` value.
+ * @param {number} max - If the `value` parameter is greater than the `max` value,
+ * the function will return `max`.
+ * @returns The `clamp` function returns the value of `value` constrained within the range defined by
+ * `min` and `max`.
+ */
+function clamp(value, min = Number.NEGATIVE_INFINITY, max = Number.POSITIVE_INFINITY) {
+    return Math.min(max, Math.max(min, value));
+}
+/**
+ * The function `roundToStepPrecision` rounds a number to a specified precision step.
+ * @param {number} value - The `value` parameter is the number that you want to round to a specific
+ * precision based on the `step` parameter.
+ * @param {number} step - The `step` parameter in the `roundToStepPrecision` function represents the
+ * interval at which you want to round the `value`. For example, if `step` is 0.5, the `value` will be
+ * rounded to the nearest half.
+ * @returns the `roundedValue` after rounding it to the precision specified by the `step`.
+ */
+function roundToStepPrecision(value, step) {
+    let roundedValue = value;
+    const stepString = step.toString();
+    const pointIndex = stepString.indexOf('.');
+    const precision = pointIndex >= 0 ? stepString.length - pointIndex : 0;
+    if (precision > 0) {
+        const pow = 10 ** precision;
+        roundedValue = Math.round(roundedValue * pow) / pow;
+    }
+    return roundedValue;
+}
+/**
+ * The function `snapValueToStep` snaps a given value to the nearest step within a specified range.
+ * @param {number} value - The `value` parameter represents the number that you want to snap to the
+ * nearest step value.
+ * @param {number | undefined} min - The `min` parameter represents the minimum value that the `value`
+ * should be snapped to. If `value` is less than `min`, it will be snapped to `min`. If `min` is not
+ * provided (undefined), then the snapping will not consider a minimum value.
+ * @param {number | undefined} max - The `max` parameter represents the maximum value that the `value`
+ * should be snapped to. It ensures that the snapped value does not exceed this maximum value.
+ * @param {number} step - The `step` parameter in the `snapValueToStep` function represents the
+ * interval at which the `value` should be snapped to. It determines the granularity of the snapping
+ * operation. For example, if `step` is 5, the `value` will be snapped to the nearest multiple of
+ * @returns a number that has been snapped to the nearest step value within the specified range of minimum and maximum values.
+ */
+function snapValueToStep(value, min, max, step) {
+    min = Number(min);
+    max = Number(max);
+    const remainder = (value - (Number.isNaN(min) ? 0 : min)) % step;
+    let snappedValue = roundToStepPrecision(Math.abs(remainder) * 2 >= step
+        ? value + Math.sign(remainder) * (step - Math.abs(remainder))
+        : value - remainder, step);
+    if (!Number.isNaN(min)) {
+        if (snappedValue < min)
+            snappedValue = min;
+        else if (!Number.isNaN(max) && snappedValue > max)
+            snappedValue = min + Math.floor(roundToStepPrecision((max - min) / step, step)) * step;
+    }
+    else if (!Number.isNaN(max) && snappedValue > max) {
+        snappedValue = Math.floor(roundToStepPrecision(max / step, step)) * step;
+    }
+    // correct floating point behavior by rounding to step precision
+    snappedValue = roundToStepPrecision(snappedValue, step);
+    return snappedValue;
+}
+
 function injectDocument() {
     return inject(DOCUMENT);
 }
@@ -124,6 +194,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.4", ngImpor
                 }]
         }] });
 
+function getActiveElement() {
+    let activeElement = document.activeElement;
+    if (activeElement == null) {
+        return null;
+    }
+    while (activeElement != null &&
+        activeElement.shadowRoot != null &&
+        activeElement.shadowRoot.activeElement != null) {
+        activeElement = activeElement.shadowRoot.activeElement;
+    }
+    return activeElement;
+}
+
 /**
  * @license
  * Copyright Google LLC All Rights Reserved.
@@ -2017,5 +2100,5 @@ function watch(deps, fn, options) {
  * Generated bundle index. Do not edit.
  */
 
-export { A, ALT, ARROW_DOWN, ARROW_LEFT, ARROW_RIGHT, ARROW_UP, ASTERISK, BACKSPACE, CAPS_LOCK, CONTROL, CTRL, DELETE, END, ENTER, ESCAPE, F1, F10, F11, F12, F2, F3, F4, F5, F6, F7, F8, F9, HOME, META, P, PAGE_DOWN, PAGE_UP, RDX_POSITIONING_DEFAULTS, RDX_POSITIONS, RdxAutoFocusDirective, RdxFocusInitialDirective, RdxPositionAlign, RdxPositionSide, SHIFT, SPACE, SPACE_CODE, TAB, WINDOW, _IdGenerator, a, areAllDaysBetweenValid, createContent, createFormatter, createMonth, createMonths, getAllPossibleConnectedPositions, getArrowPositionParams, getContentPosition, getDaysBetween, getDaysInMonth, getDefaultDate, getLastFirstDayOfWeek, getNextLastDayOfWeek, getOptsByGranularity, getPlaceholder, getSegmentElements, getSideAndAlignFromAllPossibleConnectedPositions, handleCalendarInitialFocus, hasTime, initializeSegmentValues, injectDocument, injectIsClient, injectNgControl, injectWindow, isAcceptableSegmentKey, isAfter, isAfterOrSame, isBefore, isBeforeOrSame, isBetween, isBetweenInclusive, isCalendarDateTime, isInsideForm, isNullish, isNumber, isNumberString, isSegmentNavigationKey, isZonedDateTime, j, k, n, p, provideToken, provideValueAccessor, segmentBuilders, syncSegmentValues, syncTimeSegmentValues, toDate, useDateField, watch };
+export { A, ALT, ARROW_DOWN, ARROW_LEFT, ARROW_RIGHT, ARROW_UP, ASTERISK, BACKSPACE, CAPS_LOCK, CONTROL, CTRL, DELETE, END, ENTER, ESCAPE, F1, F10, F11, F12, F2, F3, F4, F5, F6, F7, F8, F9, HOME, META, P, PAGE_DOWN, PAGE_UP, RDX_POSITIONING_DEFAULTS, RDX_POSITIONS, RdxAutoFocusDirective, RdxFocusInitialDirective, RdxPositionAlign, RdxPositionSide, SHIFT, SPACE, SPACE_CODE, TAB, WINDOW, _IdGenerator, a, areAllDaysBetweenValid, clamp, createContent, createFormatter, createMonth, createMonths, getActiveElement, getAllPossibleConnectedPositions, getArrowPositionParams, getContentPosition, getDaysBetween, getDaysInMonth, getDefaultDate, getLastFirstDayOfWeek, getNextLastDayOfWeek, getOptsByGranularity, getPlaceholder, getSegmentElements, getSideAndAlignFromAllPossibleConnectedPositions, handleCalendarInitialFocus, hasTime, initializeSegmentValues, injectDocument, injectIsClient, injectNgControl, injectWindow, isAcceptableSegmentKey, isAfter, isAfterOrSame, isBefore, isBeforeOrSame, isBetween, isBetweenInclusive, isCalendarDateTime, isInsideForm, isNullish, isNumber, isNumberString, isSegmentNavigationKey, isZonedDateTime, j, k, n, p, provideToken, provideValueAccessor, roundToStepPrecision, segmentBuilders, snapValueToStep, syncSegmentValues, syncTimeSegmentValues, toDate, useDateField, watch };
 //# sourceMappingURL=radix-ng-primitives-core.mjs.map