@graphprotocol/gds-react 0.0.1

package/dist/hooks/useForceRerender.js

@@ -0,0 +1,13 @@
+import { useCallback, useState } from 'react';
+/**
+ * Hook that provides a function to force a component to re-render. Returns a tuple of `[rerender
+ * function, rerender count]`.
+ */
+export function useForceRerender() {
+    const [rerenderCount, setRerenderCount] = useState(0);
+    const rerender = useCallback(() => {
+        setRerenderCount((count) => count + 1);
+    }, []);
+    return [rerender, rerenderCount];
+}
+//# sourceMappingURL=useForceRerender.js.map

package/dist/hooks/useForceRerender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForceRerender.js","sourceRoot":"","sources":["../../src/hooks/useForceRerender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE7C;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IACrD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,gBAAgB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IACxC,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAU,CAAA;AAC3C,CAAC"}

package/dist/hooks/useGDS.d.ts

@@ -0,0 +1,9 @@
+/** Throws an error if used outside of a `GDSProvider`. */
+export declare function useGDS(): {
+    activeTheme: "dark" | "light";
+    dirProps: {
+        dir: NonNullable<import("@base-ui-components/react/direction-provider").TextDirection | undefined>;
+        lang: string;
+    };
+};
+//# sourceMappingURL=useGDS.d.ts.map

package/dist/hooks/useGDS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGDS.d.ts","sourceRoot":"","sources":["../../src/hooks/useGDS.ts"],"names":[],"mappings":"AAIA,0DAA0D;AAC1D,wBAAgB,MAAM;;;;;;EAcrB"}

package/dist/hooks/useGDS.js

@@ -0,0 +1,17 @@
+import { useContext } from 'react';
+import { GDSContext } from "../GDSProvider.js";
+/** Throws an error if used outside of a `GDSProvider`. */
+export function useGDS() {
+    const context = useContext(GDSContext);
+    if (context === null) {
+        throw new Error('GDS components must be wrapped in a `GDSProvider`');
+    }
+    return {
+        activeTheme: context.activeTheme,
+        dirProps: {
+            dir: context.direction,
+            lang: context.language,
+        },
+    };
+}
+//# sourceMappingURL=useGDS.js.map

package/dist/hooks/useGDS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGDS.js","sourceRoot":"","sources":["../../src/hooks/useGDS.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAoB,CAAA;AAE/C,0DAA0D;AAC1D,MAAM,UAAU,MAAM;IACpB,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IAEtC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IAED,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE;YACR,GAAG,EAAE,OAAO,CAAC,SAAS;YACtB,IAAI,EAAE,OAAO,CAAC,QAAQ;SACvB;KACF,CAAA;AACH,CAAC"}

package/dist/hooks/useMapWithInit.d.ts

@@ -0,0 +1,7 @@
+import { useMap } from '@react-hookz/web';
+/**
+ * Hook that combines useMap with lazy initialization. The init function runs once on the first
+ * render.
+ */
+export declare function useMapWithInit<T extends (readonly [unknown, unknown])[]>(initFn: () => T): ReturnType<typeof useMap<T[number][0], T[number][1]>>;
+//# sourceMappingURL=useMapWithInit.d.ts.map

package/dist/hooks/useMapWithInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapWithInit.d.ts","sourceRoot":"","sources":["../../src/hooks/useMapWithInit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAIzC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,EACtE,MAAM,EAAE,MAAM,CAAC,GACd,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAGvD"}

package/dist/hooks/useMapWithInit.js

@@ -0,0 +1,11 @@
+import { useMap } from '@react-hookz/web';
+import { useRefWithInit } from "./useRefWithInit.js";
+/**
+ * Hook that combines useMap with lazy initialization. The init function runs once on the first
+ * render.
+ */
+export function useMapWithInit(initFn) {
+    const initialValue = useRefWithInit(initFn).current;
+    return useMap(initialValue);
+}
+//# sourceMappingURL=useMapWithInit.js.map

package/dist/hooks/useMapWithInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapWithInit.js","sourceRoot":"","sources":["../../src/hooks/useMapWithInit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAe;IAEf,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,OAAO,CAAA;IACnD,OAAO,MAAM,CAAC,YAAY,CAAC,CAAA;AAC7B,CAAC"}

package/dist/hooks/useNumberInput.d.ts

@@ -0,0 +1,55 @@
+import { type Ref } from 'react';
+import { type BigIntFormatOptions } from '@graphprotocol/gds-utils';
+import type { InputProps } from '../components/Input.tsx';
+export interface UseNumberInputOptions<UseBigInt extends boolean = false, T = UseBigInt extends true ? bigint : number> {
+    ref?: Ref<HTMLInputElement> | undefined;
+    /** @default false */
+    useBigInt?: UseBigInt | undefined;
+    /** @default 18n */
+    precision?: bigint | undefined;
+    /** @default null */
+    defaultValue?: T | null | undefined;
+    value?: T | null | undefined;
+    onChange?: ((value: T | null) => void) | undefined;
+    /** @default false */
+    required?: boolean | undefined;
+    /** @default null */
+    min?: T | null | undefined;
+    /** @default null */
+    max?: T | null | undefined;
+    /**
+     * @default {
+     *   minimumFractionDigits: 0
+     *   maximumFractionDigits: 20
+     *   trailingZeroDisplay: 'auto'
+     * }
+     */
+    format?: BigIntFormatOptions | undefined;
+}
+export type UseNumberInputError = 'NOT_A_NUMBER' | 'EMPTY' | 'BELOW_MIN' | 'ABOVE_MAX';
+export interface UseNumberInputReturnedObject<T = number | bigint> {
+    /**
+     * `null` means the input is either empty or invalid (or both, if `required` is true); check
+     * `error` for more info.
+     */
+    value: T | null;
+    setValue: (value: T | null) => void;
+    error: UseNumberInputError | null;
+    nonValidatedValue: bigint | null;
+    nearestValidValue: T;
+    props: {
+        ref: Ref<HTMLInputElement>;
+        type: 'number';
+        value: InputProps['value'];
+        onKeyDown: InputProps['onKeyDown'];
+        onChange: InputProps['onChange'];
+        onBlur: InputProps['onBlur'];
+        required?: InputProps['required'] | undefined;
+        min?: InputProps['min'] | undefined;
+        max?: InputProps['max'] | undefined;
+        status?: InputProps['status'] | undefined;
+        message?: InputProps['message'] | undefined;
+    };
+}
+export declare function useNumberInput<UseBigInt extends boolean = false, T = UseBigInt extends true ? bigint : number>({ ref: passedRef, useBigInt, precision, defaultValue, value: controlledValue, onChange: controlledOnChange, required, min: passedMin, max: passedMax, format, }?: UseNumberInputOptions<UseBigInt>): UseNumberInputReturnedObject<T>;
+//# sourceMappingURL=useNumberInput.d.ts.map

package/dist/hooks/useNumberInput.d.ts.map

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

package/dist/hooks/useNumberInput.js

@@ -0,0 +1,295 @@
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { useMergedRefs } from '@base-ui-components/utils/useMergedRefs';
+import { bigIntToNumber, formatBigInt, numberToBigInt, parseBigInt, } from '@graphprotocol/gds-utils';
+import { useForceRerender } from "./useForceRerender.js";
+import { usePrevious } from "./usePrevious.js";
+export function useNumberInput({ ref: passedRef, useBigInt = false, precision = 18n, defaultValue = null, value: controlledValue, onChange: controlledOnChange, required = false, min: passedMin = null, max: passedMax = null, format = {}, } = {}) {
+    if (passedMin !== null && passedMax !== null && passedMin > passedMax) {
+        throw new Error('[useNumberInput] `min` cannot be greater than `max`');
+    }
+    const inputRef = useRef(null);
+    const inputPassedRef = useMergedRefs(inputRef, passedRef);
+    const normalizeValue = (value) => {
+        if (typeof value === 'number') {
+            return numberToBigInt(value, { precision });
+        }
+        else if (typeof value === 'bigint') {
+            return value;
+        }
+        else {
+            return null;
+        }
+    };
+    const denormalizeValue = (value) => {
+        if (value === null) {
+            return null;
+        }
+        else if (useBigInt) {
+            return value;
+        }
+        else {
+            return bigIntToNumber(value, { precision });
+        }
+    };
+    const formatValue = (value, overrides) => {
+        if (value === null)
+            return '';
+        return formatBigInt(value, { precision, ...format, ...overrides });
+    };
+    const defaultMin = useBigInt ? null : Number.MIN_SAFE_INTEGER;
+    const defaultMax = useBigInt ? null : Number.MAX_SAFE_INTEGER;
+    const min = normalizeValue(passedMin ?? defaultMin);
+    const max = normalizeValue(passedMax ?? defaultMax);
+    const allowNegative = min === null || min < 0n;
+    const allowDecimals = precision > 0n;
+    const validateValue = (value) => {
+        if (value === null) {
+            if (required) {
+                return 'EMPTY';
+            }
+            return null;
+        }
+        if (min !== null && value < min) {
+            return 'BELOW_MIN';
+        }
+        if (max !== null && value > max) {
+            return 'ABOVE_MAX';
+        }
+        return null;
+    };
+    const derivedFromProps = (() => {
+        const normalizedValue = normalizeValue(controlledValue !== undefined ? controlledValue : defaultValue);
+        const error = validateValue(normalizedValue);
+        const validatedValue = !error ? normalizedValue : null;
+        return {
+            normalizedValue,
+            error,
+            validatedValue,
+        };
+    })();
+    const [typing, setTyping] = useState(false);
+    const [inputValue, setInputValue] = useState(() => formatValue(derivedFromProps.normalizedValue));
+    const [validatedValue, setValidatedValue] = useState(derivedFromProps.validatedValue);
+    const [error, setError] = useState(derivedFromProps.error !== 'EMPTY' ? derivedFromProps.error : null);
+    const [errorOnBlur, setErrorOnBlur] = useState(error);
+    const [nonValidatedValue, setNonValidatedValue] = useState(derivedFromProps.normalizedValue);
+    let nearestValidValue = nonValidatedValue ?? 0n;
+    if (min !== null && (nonValidatedValue ?? 0n) < min) {
+        nearestValidValue = min;
+    }
+    if (max !== null && (nonValidatedValue ?? 0n) > max) {
+        nearestValidValue = max;
+    }
+    const setValue = (newValue, { updateInputValue = true, callOnChange = false, } = {}) => {
+        const normalizedValue = normalizeValue(newValue);
+        const formattedValue = formatValue(normalizedValue);
+        const newError = validateValue(normalizedValue);
+        if (updateInputValue)
+            setInputValue(formattedValue);
+        setNonValidatedValue(normalizedValue);
+        if (normalizedValue === null || newError) {
+            setValidatedValue(null);
+            if (callOnChange)
+                controlledOnChange?.(null);
+            setError(newError);
+            return;
+        }
+        // The passed value may have more decimals than we allow, so we parse the formatted value to truncate those
+        const parsedValue = parseBigInt(formattedValue, { precision });
+        setValidatedValue(parsedValue);
+        if (callOnChange) {
+            ;
+            controlledOnChange?.(denormalizeValue(parsedValue));
+        }
+        setError(null);
+    };
+    // Update internal values when a prop changes externally that might affect the value or the error
+    const previousControlledValue = usePrevious(controlledValue);
+    const previousRequired = usePrevious(required);
+    const previousMin = usePrevious(passedMin);
+    const previousMax = usePrevious(passedMax);
+    if ((previousControlledValue.hasChanged &&
+        (controlledValue === undefined || normalizeValue(controlledValue) !== validatedValue)) ||
+        previousRequired.hasChanged ||
+        previousMin.hasChanged ||
+        previousMax.hasChanged) {
+        if (previousControlledValue.hasChanged && controlledValue !== undefined) {
+            setValue(controlledValue);
+        }
+        else {
+            setValue(denormalizeValue(nonValidatedValue));
+        }
+    }
+    const getSignificantCaretPositionMap = (string) => {
+        const significantCaretPositionMap = [];
+        let significantCaretPosition = 0;
+        let hasDecimalPoint = false;
+        let hasSignificantDigit = false;
+        significantCaretPositionMap.push(significantCaretPosition);
+        for (let i = 0; i < string.length; i++) {
+            const character = string[i];
+            if (character === '-' && significantCaretPosition === 0) {
+                significantCaretPosition++;
+            }
+            else if (character === '.' && !hasDecimalPoint) {
+                significantCaretPosition++;
+                hasDecimalPoint = true;
+                // Handle typing `.5` (instead of `0.5`)
+                if (string[i - 1] !== '0') {
+                    significantCaretPosition++;
+                }
+            }
+            else if (/\d/.test(character)) {
+                if (character === '0' && !hasSignificantDigit) {
+                    if (string[i - 1] === '.' || string[i + 1] === '.') {
+                        significantCaretPosition++;
+                        hasSignificantDigit = true;
+                    }
+                }
+                else {
+                    significantCaretPosition++;
+                    hasSignificantDigit = true;
+                }
+            }
+            significantCaretPositionMap.push(significantCaretPosition);
+        }
+        return significantCaretPositionMap;
+    };
+    const getSignificantCaretPosition = (input) => {
+        const significantCaretPositionMap = getSignificantCaretPositionMap(input.value);
+        return significantCaretPositionMap[input.selectionStart !== null && input.selectionStart < significantCaretPositionMap.length
+            ? input.selectionStart
+            : significantCaretPositionMap.length];
+    };
+    const setSignificantCaretPosition = (input, position) => {
+        const significantCaretPositionMap = getSignificantCaretPositionMap(input.value);
+        let actualCaretPosition = significantCaretPositionMap.indexOf(position);
+        if (actualCaretPosition === -1) {
+            actualCaretPosition = input.value.length;
+        }
+        input.setSelectionRange(actualCaretPosition, actualCaretPosition);
+    };
+    const previousSignificantCaretPosition = useRef(null);
+    const [forceRerender] = useForceRerender();
+    const charsToRemove = useMemo(() => new RegExp(`[^\\d,${allowNegative ? '-' : ''}${allowDecimals ? '.' : ''}]`, 'g'), [allowNegative, allowDecimals]);
+    const onKeyDown = (event) => {
+        const allowKeyPress = event.ctrlKey ||
+            event.metaKey ||
+            /\d/.test(event.key) ||
+            (allowNegative && event.key === '-') ||
+            (allowDecimals && event.key === '.') ||
+            // TODO: Fix stuck caret when pressing Delete to the left of a comma
+            // TODO: Fix caret sometimes not ending up in the correct position when pressing Delete to the left of the decimal point
+            ['Backspace', 'Delete', 'ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown', 'Tab'].includes(event.key);
+        if (!allowKeyPress) {
+            event.preventDefault();
+        }
+    };
+    const onChange = (newInputValue) => {
+        setTyping(true);
+        if (inputRef.current) {
+            previousSignificantCaretPosition.current = getSignificantCaretPosition(inputRef.current);
+        }
+        // Remove all characters except digits, commas, minus signs (if allowed), and decimal points (if allowed)
+        let cleanedValue = newInputValue.replace(charsToRemove, '');
+        // Remove minus signs that are not at the beginning of the string
+        if (allowNegative) {
+            cleanedValue = cleanedValue.replace(/(?!^)-/g, '');
+        }
+        // Remove decimal points except the first one
+        if (allowDecimals) {
+            const cleanedValueParts = cleanedValue.split('.');
+            cleanedValue =
+                cleanedValueParts.length > 1
+                    ? `${cleanedValueParts.shift()}.${cleanedValueParts.join('')}`
+                    : cleanedValueParts[0];
+        }
+        setInputValue(cleanedValue);
+        if (cleanedValue === '') {
+            setValue(null, {
+                updateInputValue: false,
+                callOnChange: true,
+            });
+            return;
+        }
+        const parsedValue = parseBigInt(cleanedValue, { precision });
+        if (parsedValue === null) {
+            setValidatedValue(null);
+            controlledOnChange?.(null);
+            setError('NOT_A_NUMBER');
+            return;
+        }
+        setValue(parsedValue, {
+            updateInputValue: false,
+            callOnChange: true,
+        });
+        // Don't format potentially intermediate values like `-0` (in case we're typing `-0.1`), `1.` (for `1.5`), or `1.50` (for `1.501`)
+        // Those cases will be formatted on blur instead
+        if (!/^-0+$/.test(cleanedValue) && !/\.((.*)0+)?$/.test(cleanedValue)) {
+            setInputValue(formatValue(parsedValue, { minimumFractionDigits: 0, maximumFractionDigits: 20 }));
+        }
+        // Ensure the caret position is updated correctly when pressing backspace on a comma
+        forceRerender();
+    };
+    // Ensure the caret is in the correct position after the value changes
+    useEffect(() => {
+        if (!inputRef.current || previousSignificantCaretPosition.current === null)
+            return;
+        const significantCaretPosition = getSignificantCaretPosition(inputRef.current);
+        if (significantCaretPosition !== previousSignificantCaretPosition.current) {
+            setSignificantCaretPosition(inputRef.current, previousSignificantCaretPosition.current);
+        }
+        previousSignificantCaretPosition.current = null;
+    });
+    const onBlur = () => {
+        setTyping(false);
+        setErrorOnBlur(error);
+        const parsedValue = parseBigInt(inputValue, { precision });
+        if (parsedValue !== null) {
+            setInputValue(formatValue(parsedValue));
+        }
+    };
+    const status = error ? 'error' : undefined;
+    let message;
+    if (error) {
+        switch (error) {
+            case 'NOT_A_NUMBER':
+                message = 'Please enter a valid number.';
+                break;
+            case 'EMPTY':
+                message = 'This field is required.';
+                break;
+            case 'BELOW_MIN':
+                message = `This field's value cannot be less than ${formatValue(min)}.`;
+                break;
+            case 'ABOVE_MAX':
+                message = `This field's value cannot be greater than ${formatValue(max)}.`;
+                break;
+        }
+    }
+    // Only show the error message when not typing, or while typing until the input is valid again
+    if (typing && error !== errorOnBlur) {
+        message = undefined;
+    }
+    return {
+        value: denormalizeValue(validatedValue),
+        setValue: setValue,
+        error,
+        nonValidatedValue,
+        nearestValidValue: denormalizeValue(nearestValidValue),
+        props: {
+            ref: inputPassedRef,
+            type: 'number',
+            value: inputValue,
+            onKeyDown,
+            onChange,
+            onBlur,
+            required,
+            min: min !== null ? (bigIntToNumber(min, { precision }) ?? undefined) : undefined,
+            max: max !== null ? (bigIntToNumber(max, { precision }) ?? undefined) : undefined,
+            status,
+            message,
+        },
+    };
+}
+//# sourceMappingURL=useNumberInput.js.map

package/dist/hooks/useNumberInput.js.map

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

package/dist/hooks/usePrevious.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Hook to get the previous value of a state or prop. Returns an object with:
+ *
+ * - `hasChanged`: Whether the value has changed since the previous render / call to this function.
+ * - `value`: The value that was passed to the hook in the previous render (`undefined` on first
+ *   render).
+ * - `lastDifferentValue`: The most recent value that was different from the current value.
+ *
+ * @example
+ *
+ *     const previous = usePrevious(someValue)
+ *     if (previous.hasChanged) {
+ *       // Value changed from `previous.value` to `someValue`
+ *     }
+ */
+export declare function usePrevious<T>(value: T): {
+    hasChanged: boolean;
+    value: T | undefined;
+    lastDifferentValue: T | undefined;
+};
+//# sourceMappingURL=usePrevious.d.ts.map

package/dist/hooks/usePrevious.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrevious.d.ts","sourceRoot":"","sources":["../../src/hooks/usePrevious.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;;;;EAiBtC"}

package/dist/hooks/usePrevious.js

@@ -0,0 +1,33 @@
+import { useRef } from 'react';
+const NOT_SET = Symbol('NOT_SET');
+/**
+ * Hook to get the previous value of a state or prop. Returns an object with:
+ *
+ * - `hasChanged`: Whether the value has changed since the previous render / call to this function.
+ * - `value`: The value that was passed to the hook in the previous render (`undefined` on first
+ *   render).
+ * - `lastDifferentValue`: The most recent value that was different from the current value.
+ *
+ * @example
+ *
+ *     const previous = usePrevious(someValue)
+ *     if (previous.hasChanged) {
+ *       // Value changed from `previous.value` to `someValue`
+ *     }
+ */
+export function usePrevious(value) {
+    const previousRenderValueRef = useRef(NOT_SET);
+    const lastDifferentValueRef = useRef(NOT_SET);
+    const previousRenderValue = previousRenderValueRef.current;
+    const hasChanged = previousRenderValueRef.current !== NOT_SET && previousRenderValue !== value;
+    if (hasChanged) {
+        lastDifferentValueRef.current = previousRenderValue;
+    }
+    previousRenderValueRef.current = value;
+    return {
+        hasChanged,
+        value: previousRenderValueRef.current !== NOT_SET ? previousRenderValue : undefined,
+        lastDifferentValue: lastDifferentValueRef.current !== NOT_SET ? lastDifferentValueRef.current : undefined,
+    };
+}
+//# sourceMappingURL=usePrevious.js.map

package/dist/hooks/usePrevious.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrevious.js","sourceRoot":"","sources":["../../src/hooks/usePrevious.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAE9B,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;AAEjC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAI,KAAQ;IACrC,MAAM,sBAAsB,GAAG,MAAM,CAAqB,OAAO,CAAC,CAAA;IAClE,MAAM,qBAAqB,GAAG,MAAM,CAAqB,OAAO,CAAC,CAAA;IAEjE,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,OAAO,CAAA;IAC1D,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,KAAK,OAAO,IAAI,mBAAmB,KAAK,KAAK,CAAA;IAC9F,IAAI,UAAU,EAAE,CAAC;QACf,qBAAqB,CAAC,OAAO,GAAG,mBAAmB,CAAA;IACrD,CAAC;IACD,sBAAsB,CAAC,OAAO,GAAG,KAAK,CAAA;IAEtC,OAAO;QACL,UAAU;QACV,KAAK,EAAE,sBAAsB,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAE,mBAAyB,CAAC,CAAC,CAAC,SAAS;QAC1F,kBAAkB,EAChB,qBAAqB,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAE,qBAAqB,CAAC,OAAa,CAAC,CAAC,CAAC,SAAS;KAC/F,CAAA;AACH,CAAC"}

package/dist/hooks/useRefWithInit.d.ts

@@ -0,0 +1,7 @@
+import { type MutableRefObject } from 'react';
+/**
+ * Works like `useRef` but accepts an initializer function that runs once on the first render, like
+ * `useState`.
+ */
+export declare function useRefWithInit<T>(initFn: () => T): MutableRefObject<T>;
+//# sourceMappingURL=useRefWithInit.d.ts.map

package/dist/hooks/useRefWithInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefWithInit.d.ts","sourceRoot":"","sources":["../../src/hooks/useRefWithInit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAErD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAOjC,gBAAgB,CAAC,CAAC,CAAC,CAClC"}

package/dist/hooks/useRefWithInit.js

@@ -0,0 +1,13 @@
+import { useRef } from 'react';
+/**
+ * Works like `useRef` but accepts an initializer function that runs once on the first render, like
+ * `useState`.
+ */
+export function useRefWithInit(initFn) {
+    const ref = useRef(undefined);
+    if (ref.current === undefined) {
+        ref.current = initFn();
+    }
+    return ref;
+}
+//# sourceMappingURL=useRefWithInit.js.map

package/dist/hooks/useRefWithInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefWithInit.js","sourceRoot":"","sources":["../../src/hooks/useRefWithInit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAyB,MAAM,OAAO,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAI,MAAe;IAC/C,MAAM,GAAG,GAAG,MAAM,CAAgB,SAAS,CAAC,CAAA;IAE5C,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,GAAG,CAAC,OAAO,GAAG,MAAM,EAAE,CAAA;IACxB,CAAC;IAED,OAAO,GAA0B,CAAA;AACnC,CAAC"}

package/dist/hooks/useStyle.d.ts

@@ -0,0 +1,11 @@
+import type { Ref } from 'react';
+/**
+ * Hook that returns a style object with observed CSS property values. Automatically updates when
+ * the observed properties change.
+ */
+export declare function useStyle<T extends string>(properties: T[], options?: {
+    ref?: Ref<HTMLElement> | undefined;
+    initialValues?: Record<T, string>;
+    onChange?: (values: Record<T, string>) => void;
+}): readonly [import("react").RefCallback<HTMLElement>, Record<T, string | undefined>];
+//# sourceMappingURL=useStyle.d.ts.map

package/dist/hooks/useStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStyle.d.ts","sourceRoot":"","sources":["../../src/hooks/useStyle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAKhC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvC,UAAU,EAAE,CAAC,EAAE,EACf,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,SAAS,CAAA;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;IACjC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,CAAA;CAC1C,sFAkCP"}

package/dist/hooks/useStyle.js

@@ -0,0 +1,31 @@
+import { useMapWithInit } from "./useMapWithInit.js";
+import { useStyleObserver } from "./useStyleObserver.js";
+/**
+ * Hook that returns a style object with observed CSS property values. Automatically updates when
+ * the observed properties change.
+ */
+export function useStyle(properties, options = {}) {
+    const { ref, initialValues, onChange } = options;
+    const propertyValues = useMapWithInit(() => initialValues
+        ? Object.entries(initialValues)
+        : properties.map((property) => [property, undefined]));
+    const callbackRef = useStyleObserver(properties, (records) => {
+        let changed = false;
+        for (const record of records) {
+            if (propertyValues.get(record.property) !== record.value) {
+                propertyValues.set(record.property, record.value);
+                changed = true;
+            }
+        }
+        if (changed) {
+            /**
+             * This assertion is safe because `immediate: true` means that all watched properties will
+             * be included in the first call (and any property that is not set will be an empty string
+             * rather than `undefined`; see `record.value`'s type).
+             */
+            onChange?.(Object.fromEntries(propertyValues));
+        }
+    }, [], { ...(ref !== undefined && { ref }), immediate: true });
+    return [callbackRef, Object.fromEntries(propertyValues)];
+}
+//# sourceMappingURL=useStyle.js.map

package/dist/hooks/useStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStyle.js","sourceRoot":"","sources":["../../src/hooks/useStyle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,UAAe,EACf,UAII,EAAE;IAEN,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAA;IAEhD,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,EAAE,CACzC,aAAa;QACX,CAAC,CAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAmB;QAClD,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CACxD,CAAA;IAED,MAAM,WAAW,GAAG,gBAAgB,CAClC,UAAU,EACV,CAAC,OAAO,EAAE,EAAE;QACV,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;gBACzD,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;gBACjD,OAAO,GAAG,IAAI,CAAA;YAChB,CAAC;QACH,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ;;;;eAIG;YACH,QAAQ,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAsB,CAAC,CAAA;QACrE,CAAC;IACH,CAAC,EACD,EAAE,EACF,EAAE,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CACvD,CAAA;IAED,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,cAAc,CAAkC,CAAU,CAAA;AACpG,CAAC"}

package/dist/hooks/useStyleObserver.d.ts

@@ -0,0 +1,16 @@
+import { type Ref } from 'react';
+import StyleObserver from 'style-observer';
+type Record<T extends string> = Parameters<ConstructorParameters<typeof StyleObserver>[0]>[0][0] & {
+    property: T;
+};
+/**
+ * Hook that observes style changes on an element. Calls the `onChange` callback whenever specified
+ * CSS properties change.
+ */
+export declare function useStyleObserver<T extends string>(properties: T[], onChange: (records: Record<T>[]) => void, deps: unknown[], options?: {
+    ref?: Ref<HTMLElement> | undefined;
+    immediate?: boolean;
+    disabled?: boolean;
+}): import("react").RefCallback<HTMLElement>;
+export {};
+//# sourceMappingURL=useStyleObserver.d.ts.map

package/dist/hooks/useStyleObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStyleObserver.d.ts","sourceRoot":"","sources":["../../src/hooks/useStyleObserver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,GAAG,EAAE,MAAM,OAAO,CAAA;AAEtE,OAAO,aAAa,MAAM,gBAAgB,CAAA;AAK1C,KAAK,MAAM,CAAC,CAAC,SAAS,MAAM,IAAI,UAAU,CAAC,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IACjG,QAAQ,EAAE,CAAC,CAAA;CACZ,CAAA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,UAAU,EAAE,CAAC,EAAE,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EACxC,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,4CAiD9F"}