@codecademy/gamut 68.2.0-alpha.a8fc55.0 → 68.2.0

package/dist/BarChart/utils/hooks.js

@@ -0,0 +1,281 @@
+import { isColorAlias, useColorModes } from '@codecademy/gamut-styles';
+import { getContrast } from 'polished';
+import { useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { BarChartContext, defaultStyleConfig } from '../BarChartProvider';
+import { calculatePositionPercent, getLabel, sortBars } from './index';
+/**
+ * Hook that calculates label positions for a given maxScaleValue and tickCount (scale min is always 0).
+ * Returns an array of { value, positionPercent } objects.
+ */
+export const useLabelPositions = ({
+  maxScaleValue,
+  tickCount
+}) => {
+  return useMemo(() => Array.from({
+    length: tickCount
+  }, (_, i) => {
+    const value = getLabel({
+      labelIndex: i,
+      maxScaleValue,
+      tickCount
+    });
+    const positionPercent = calculatePositionPercent({
+      value,
+      maxScaleValue
+    });
+    return {
+      value,
+      positionPercent
+    };
+  }), [maxScaleValue, tickCount]);
+};
+export const useBarChartContext = () => {
+  return useContext(BarChartContext);
+};
+export const useBarChart = ({
+  maxScaleValue,
+  scaleInterval,
+  unit = '',
+  styleConfig,
+  animate = false,
+  barCount = 0,
+  translations
+}) => {
+  const [widestCategoryLabelWidth, setWidestCategoryLabelWidthState] = useState(null);
+  const [widestTotalValueLabelWidth, setWidestTotalValueLabelWidthState] = useState(null);
+  const [isMeasuring, setIsMeasuring] = useState(true);
+  const measuredCountRef = useRef(0);
+  const maxCategoryLabelWidthRef = useRef(0);
+  const maxTotalValueLabelWidthRef = useRef(0);
+  const setWidestCategoryLabelWidth = useCallback(width => {
+    if (width > maxCategoryLabelWidthRef.current) {
+      maxCategoryLabelWidthRef.current = width;
+      setWidestCategoryLabelWidthState(width);
+    }
+    measuredCountRef.current += 1;
+    // Only stop measuring when we've received measurements from all bars
+    if (measuredCountRef.current >= barCount * 2 && barCount > 0) {
+      setIsMeasuring(false);
+    }
+  }, [barCount]);
+  const setWidestTotalValueLabelWidth = useCallback(width => {
+    if (width > maxTotalValueLabelWidthRef.current) {
+      maxTotalValueLabelWidthRef.current = width;
+      setWidestTotalValueLabelWidthState(width);
+    }
+    measuredCountRef.current += 1;
+    // Only stop measuring when we've received measurements from all bars (category + total value)
+    if (measuredCountRef.current >= barCount * 2 && barCount > 0) {
+      setIsMeasuring(false);
+    }
+  }, [barCount]);
+  useEffect(() => {
+    if (barCount > 0) {
+      measuredCountRef.current = 0;
+      maxCategoryLabelWidthRef.current = 0;
+      maxTotalValueLabelWidthRef.current = 0;
+      setIsMeasuring(true);
+    }
+  }, [barCount]);
+  return useMemo(() => ({
+    maxScaleValue,
+    scaleInterval: scaleInterval ?? Math.ceil(maxScaleValue / 5),
+    unit,
+    styleConfig: {
+      ...defaultStyleConfig,
+      ...styleConfig
+    },
+    animate,
+    widestCategoryLabelWidth,
+    setWidestCategoryLabelWidth,
+    widestTotalValueLabelWidth,
+    setWidestTotalValueLabelWidth,
+    isMeasuring,
+    translations
+  }), [maxScaleValue, scaleInterval, unit, styleConfig, animate, widestCategoryLabelWidth, setWidestCategoryLabelWidth, widestTotalValueLabelWidth, setWidestTotalValueLabelWidth, isMeasuring, translations]);
+};
+
+/**
+ * Hook that returns a function to get the highest contrast border color
+ * (white or navy-900) for a given background color.
+ *
+ * Similar to the Background component, this resolves color aliases and
+ * compares contrast ratios to determine the best border color.
+ *
+ * @returns A function that takes a background color and returns either 'white' or 'navy-900'
+ */
+export const useBarBorderColor = () => {
+  const [, activeColors,, getColorValue] = useColorModes();
+  const getBorderColor = useCallback(bg => {
+    /** If a color alias was used then look up the true color key from the active mode */
+    const trueColor = isColorAlias(activeColors, bg) ? activeColors[bg] : bg;
+    const backgroundColor = getColorValue(trueColor);
+    const whiteContrast = getContrast(getColorValue('white'), backgroundColor);
+    const navyContrast = getContrast(getColorValue('navy-900'), backgroundColor);
+    return whiteContrast > navyContrast ? 'white' : 'navy-900';
+  }, [activeColors, getColorValue]);
+  return getBorderColor;
+};
+
+/**
+ * Generic hook for measuring element width and reporting to a callback.
+ * Used internally by useMeasureCategoryLabelWidth and useMeasureTotalValueLabelWidth.
+ */
+const useMeasureWidth = ({
+  ref,
+  onMeasure,
+  isMeasuring
+}) => {
+  const hasMeasuredRef = useRef(false);
+
+  // Reset measurement flag when a new measurement cycle starts
+  const prevIsMeasuringRef = useRef(isMeasuring);
+  useEffect(() => {
+    if (isMeasuring && !prevIsMeasuringRef.current) {
+      // New measurement cycle started
+      hasMeasuredRef.current = false;
+    }
+    prevIsMeasuringRef.current = isMeasuring;
+  }, [isMeasuring]);
+  useLayoutEffect(() => {
+    if (!ref.current || hasMeasuredRef.current || !isMeasuring) {
+      return;
+    }
+    const element = ref.current;
+    const width = element?.getBoundingClientRect()?.width;
+    if (width > 0) {
+      onMeasure(width);
+      hasMeasuredRef.current = true;
+    }
+  }, [ref, onMeasure, isMeasuring]);
+};
+export const useMeasureCategoryLabelWidth = ({
+  ref
+}) => {
+  const {
+    setWidestCategoryLabelWidth,
+    isMeasuring
+  } = useBarChartContext();
+  useMeasureWidth({
+    ref,
+    onMeasure: setWidestCategoryLabelWidth,
+    isMeasuring
+  });
+};
+export const useMeasureTotalValueLabelWidth = ({
+  ref
+}) => {
+  const {
+    setWidestTotalValueLabelWidth,
+    isMeasuring
+  } = useBarChartContext();
+  useMeasureWidth({
+    ref,
+    onMeasure: setWidestTotalValueLabelWidth,
+    isMeasuring
+  });
+};
+/**
+ * Hook that manages bar sorting state and provides memoized sorted bars.
+ * Supports predefined sort options (via string literals) and custom sort functions.
+ * Only returns selectProps if sortFns is provided.
+ */
+export const useBarChartSort = ({
+  bars,
+  sortFns,
+  translations
+}) => {
+  // Build options map and custom sort map from sortFns array
+  const {
+    allSortOptions,
+    customSortMap,
+    defaultSortValue
+  } = useMemo(() => {
+    if (!sortFns || sortFns.length === 0) {
+      return {
+        allSortOptions: null,
+        customSortMap: new Map(),
+        defaultSortValue: 'none'
+      };
+    }
+    const options = {};
+    const customMap = new Map();
+    const availableValues = [];
+    sortFns.forEach(item => {
+      if (typeof item === 'string') {
+        if (item === 'alphabetically') {
+          options['label-asc'] = translations.sortOptions.labelAsc;
+          options['label-desc'] = translations.sortOptions.labelDesc;
+          availableValues.push('label-asc', 'label-desc');
+        } else if (item === 'numerically') {
+          options['value-asc'] = translations.sortOptions.valueAsc;
+          options['value-desc'] = translations.sortOptions.valueDesc;
+          availableValues.push('value-asc', 'value-desc');
+        } else if (item === 'none') {
+          options.none = translations.sortOptions.none;
+          availableValues.push('none');
+        }
+      } else {
+        // CustomSortOption
+        options[item.value] = item.label;
+        customMap.set(item.value, item.sortFn);
+        availableValues.push(item.value);
+      }
+    });
+
+    // Default to "none" if available, otherwise first option
+    const defaultVal = availableValues.includes('none') ? 'none' : availableValues[0] || 'none';
+    return {
+      allSortOptions: options,
+      customSortMap: customMap,
+      defaultSortValue: defaultVal
+    };
+  }, [sortFns, translations]);
+  const [sortValue, setSortValue] = useState(defaultSortValue);
+
+  // Update sortValue when defaultSortValue changes (e.g., when sortFns changes)
+  useEffect(() => {
+    setSortValue(defaultSortValue);
+  }, [defaultSortValue]);
+  const sortedBars = useMemo(() => {
+    // Check if current selection is a custom sort function
+    const customSortFn = customSortMap.get(sortValue);
+    if (customSortFn) {
+      return customSortFn([...bars]);
+    }
+
+    // Otherwise use predefined sort options
+    if (sortValue === 'none') {
+      return bars;
+    }
+    const [sortBy, order] = sortValue.split('-');
+    const sortByValue = sortBy;
+    const orderValue = order === 'desc' ? 'descending' : 'ascending';
+    return sortBars({
+      bars: bars,
+      sortBy: sortByValue,
+      order: orderValue
+    });
+  }, [bars, sortValue, customSortMap]);
+  const onSortChange = useCallback(value => {
+    setSortValue(value);
+  }, []);
+  const selectProps = useMemo(() => {
+    if (!allSortOptions) {
+      return null;
+    }
+    return {
+      options: allSortOptions,
+      value: sortValue,
+      onChange: e => {
+        onSortChange(e.target.value);
+      }
+    };
+  }, [sortValue, onSortChange, allSortOptions]);
+  return {
+    sortedBars,
+    sortValue,
+    onSortChange,
+    selectProps
+  };
+};

package/dist/BarChart/utils/index.d.ts

@@ -0,0 +1,56 @@
+import { BarChartTranslations } from '../shared/translations';
+import { BarChartUnit, BarProps, MaxScaleValue, ScaleTickCount } from '../shared/types';
+export declare const calculatePercent: ({ value, total, }: {
+    value: number;
+    total: number;
+}) => number;
+export declare const calculateBarWidth: ({ value, maxScaleValue, }: {
+    value: number;
+    maxScaleValue: MaxScaleValue;
+}) => number;
+/**
+ * Formats a numeric value with optional unit for bar chart labels.
+ */
+export declare const formatValueWithUnit: ({ value, unit, locale, }: {
+    value: number;
+    unit: string;
+    locale?: string | undefined;
+}) => string;
+export declare const formatNumberUnitCompact: ({ num, locale, }: {
+    num: number;
+    locale?: string | undefined;
+}) => string;
+/**
+ * Sort bars based on sortBy and order configuration
+ */
+export declare const sortBars: <T extends BarProps>({ bars, sortBy, order, }: {
+    bars: T[];
+    sortBy: 'label' | 'value' | 'none';
+    order: 'ascending' | 'descending';
+}) => T[];
+/**
+ * Returns the accessibility summary for a bar row. The summary is used as aria-label on the row's link/button when interactive, or as screenreader-only text when not. Summaries come from stackedBarSummary (stacked rows) or singleValueBarSummary (single-value rows), with default implementations when not overridden.
+ */
+export declare const getValuesSummary: ({ seriesOneValue, seriesTwoValue, unit, categoryLabel, translations, }: Pick<BarProps, "categoryLabel" | "seriesOneValue" | "seriesTwoValue"> & Required<Pick<BarChartUnit, "unit">> & {
+    translations: BarChartTranslations;
+}) => string;
+/**
+ * Calculates the value for a given label position (scale min is always 0).
+ */
+export declare const getLabel: ({ tickCount, labelIndex, maxScaleValue, }: {
+    tickCount: ScaleTickCount;
+    labelIndex: number;
+    maxScaleValue: MaxScaleValue;
+}) => number;
+/**
+ * Calculates the percentage position for a given value within 0–maxScaleValue range.
+ * Returns a value between 0 and 100 representing the position percentage.
+ */
+export declare const calculatePositionPercent: ({ value, maxScaleValue, }: {
+    value: number;
+    maxScaleValue: MaxScaleValue;
+}) => number;
+/**
+ * Generates a stable key for a bar row (for React list keys).
+ */
+export declare const getBarRowKey: (bar: Pick<BarProps, 'categoryLabel' | 'seriesOneValue' | 'seriesTwoValue'>, index: number) => string;

package/dist/BarChart/utils/index.js

@@ -0,0 +1,122 @@
+import { getDefaultSingleValueBarSummary, getDefaultStackedBarSummary } from '../shared/translations';
+export const calculatePercent = ({
+  value,
+  total
+}) => {
+  return value / total * 100;
+};
+export const calculateBarWidth = ({
+  value,
+  maxScaleValue
+}) => {
+  const adjustedValue = Math.max(0, Math.min(maxScaleValue, value));
+  return Math.floor(calculatePercent({
+    value: adjustedValue,
+    total: maxScaleValue
+  }));
+};
+
+/**
+ * Formats a numeric value with optional unit for bar chart labels.
+ */
+export const formatValueWithUnit = ({
+  value,
+  unit,
+  locale = 'en'
+}) => {
+  const formatted = Intl.NumberFormat(locale).format(value);
+  return unit ? `${formatted} ${unit}` : formatted;
+};
+export const formatNumberUnitCompact = ({
+  num,
+  locale = 'en'
+}) => Intl.NumberFormat(locale, {
+  notation: 'compact',
+  compactDisplay: 'short'
+}).format(num);
+
+/**
+ * Sort bars based on sortBy and order configuration
+ */
+export const sortBars = ({
+  bars,
+  sortBy,
+  order
+}) => {
+  if (sortBy === 'none' || !sortBy) {
+    return bars;
+  }
+  const sorted = [...bars].sort((a, b) => {
+    if (sortBy === 'label') {
+      return a.categoryLabel.localeCompare(b.categoryLabel);
+    }
+    const aValue = a.seriesTwoValue ?? a.seriesOneValue;
+    const bValue = b.seriesTwoValue ?? b.seriesOneValue;
+    return aValue - bValue;
+  });
+  return order === 'descending' ? sorted.reverse() : sorted;
+};
+
+/**
+ * Returns the accessibility summary for a bar row. The summary is used as aria-label on the row's link/button when interactive, or as screenreader-only text when not. Summaries come from stackedBarSummary (stacked rows) or singleValueBarSummary (single-value rows), with default implementations when not overridden.
+ */
+export const getValuesSummary = ({
+  seriesOneValue,
+  seriesTwoValue,
+  unit,
+  categoryLabel,
+  translations
+}) => {
+  const {
+    locale
+  } = translations;
+  const singleValueCtx = {
+    value: seriesOneValue,
+    unit,
+    locale,
+    categoryLabel
+  };
+  if (seriesTwoValue !== undefined) {
+    const gained = seriesTwoValue - seriesOneValue;
+    const stackedCtx = {
+      categoryLabel,
+      seriesOneValue,
+      seriesTwoValue,
+      unit,
+      locale,
+      gained
+    };
+    return (translations.accessibility.stackedBarSummary ?? getDefaultStackedBarSummary)(stackedCtx);
+  }
+  return (translations.accessibility.singleValueBarSummary ?? getDefaultSingleValueBarSummary)(singleValueCtx);
+};
+
+/**
+ * Calculates the value for a given label position (scale min is always 0).
+ */
+export const getLabel = ({
+  tickCount,
+  labelIndex,
+  maxScaleValue
+}) => {
+  if (tickCount <= 1) return maxScaleValue;
+  const incrementalDecimal = labelIndex / (tickCount - 1);
+  return Math.floor(incrementalDecimal * maxScaleValue);
+};
+
+/**
+ * Calculates the percentage position for a given value within 0–maxScaleValue range.
+ * Returns a value between 0 and 100 representing the position percentage.
+ */
+export const calculatePositionPercent = ({
+  value,
+  maxScaleValue
+}) => {
+  if (maxScaleValue === 0) return 0;
+  return value / maxScaleValue * 100;
+};
+
+/**
+ * Generates a stable key for a bar row (for React list keys).
+ */
+export const getBarRowKey = (bar, index) => bar.categoryLabel && bar.seriesOneValue ? `${bar.categoryLabel}-${bar.seriesOneValue}-${bar.seriesTwoValue ?? ''}-${index}` : String(index);

package/dist/ConnectedForm/utils.d.ts

@@ -122,9 +122,9 @@ export declare function useDebouncedField<T extends InputTypes>({ name, watchUpd
     value: T extends "checkbox" ? boolean : string;
     error: string | FieldError | Merge<FieldError, FieldErrorsImpl<any>> | undefined;
     ref: import("react-hook-form").UseFormRegisterReturn<string>;
-    control: import("react-hook-form").Control<import("react-hook-form").FieldValues, any, import("react-hook-form").FieldValues>;
     isDisabled: boolean;
     isLoading: boolean | undefined;
+    control: import("react-hook-form").Control<import("react-hook-form").FieldValues, any, import("react-hook-form").FieldValues>;
     isSoloField: boolean | undefined;
     validation: RegisterOptions | undefined;
     getValues: import("react-hook-form").UseFormGetValues<import("react-hook-form").FieldValues>;

package/dist/DataList/Tables/Rows/TableHeaderRow.js

@@ -6,7 +6,7 @@ import { ExpandControl, FilterControl, SelectControl, SortControl } from '../../
 import { useControlContext } from '../../hooks/useListControls';
 import { useListState } from '../../hooks/useListState';
 import { StyledHeaderRow } from './elements';
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 export const TableHeaderRow = ({
   columns,
   selected = false,
@@ -26,62 +26,58 @@ export const TableHeaderRow = ({
     variant,
     listType
   } = useListContext();
-  const dataTablePadding = listType === 'table' && variant === 'table';
   const headerRowDirections = useListState().query?.sort;
-  return /*#__PURE__*/_jsx(StyledHeaderRow, {
+  return /*#__PURE__*/_jsxs(StyledHeaderRow, {
     invisible: invisible,
     isDataList: listType === 'table' && variant !== 'table',
-    children: /*#__PURE__*/_jsxs(_Fragment, {
-      children: [selectable && /*#__PURE__*/_jsx(ListCol, {
-        size: "content",
-        children: !hideSelectAll && /*#__PURE__*/_jsx(SelectControl, {
-          disabled: empty,
-          label: "Select All",
-          name: prefixId('all'),
-          rowId: "header",
-          selected: selected,
-          onSelect: onSelect
+    children: [selectable && /*#__PURE__*/_jsx(ListCol, {
+      size: "content",
+      children: !hideSelectAll && /*#__PURE__*/_jsx(SelectControl, {
+        disabled: empty,
+        label: "Select All",
+        name: prefixId('all'),
+        rowId: "header",
+        selected: selected,
+        onSelect: onSelect
+      })
+    }), columns.map(({
+      key,
+      header,
+      sortable,
+      filters,
+      ...colProps
+    }) => {
+      const rowProperty = key;
+      const renderKey = prefixId(`header-col-${rowProperty}`);
+      const columnText = String(header || key);
+      const sortDirection = headerRowDirections?.[rowProperty] ?? 'none';
+      const ariaSortDirection = sortDirection === 'none' ? 'none' : sortDirection === 'asc' ? 'ascending' : 'descending';
+      return /*#__PURE__*/_jsx(ListCol, {
+        ...colProps,
+        "aria-sort": sortable ? ariaSortDirection : undefined,
+        columnHeader: true,
+        children: /*#__PURE__*/_jsxs(FlexBox, {
+          alignItems: selectable ? 'center' : 'flex-end',
+          gap: 8,
+          height: "100%",
+          width: "100%",
+          children: [filters && /*#__PURE__*/_jsx(FilterControl, {
+            columnKey: rowProperty,
+            justify: colProps.justify,
+            options: filters,
+            onFilter: onFilter
+          }), sortable ? /*#__PURE__*/_jsx(SortControl, {
+            columnKey: rowProperty,
+            onSort: onSort,
+            children: columnText
+          }) : columnText]
         })
-      }), columns.map(({
-        key,
-        header,
-        sortable,
-        filters,
-        ...colProps
-      }) => {
-        const rowProperty = key;
-        const renderKey = prefixId(`header-col-${rowProperty}`);
-        const columnText = String(header || key);
-        const sortDirection = headerRowDirections?.[rowProperty] ?? 'none';
-        const ariaSortDirection = sortDirection === 'none' ? 'none' : sortDirection === 'asc' ? 'ascending' : 'descending';
-        return /*#__PURE__*/_jsx(ListCol, {
-          ...colProps,
-          "aria-sort": sortable ? ariaSortDirection : undefined,
-          columnHeader: true,
-          dataTablePadding: dataTablePadding,
-          children: /*#__PURE__*/_jsxs(FlexBox, {
-            alignItems: "flex-end",
-            gap: 8,
-            height: "100%",
-            width: "100%",
-            children: [filters && /*#__PURE__*/_jsx(FilterControl, {
-              columnKey: rowProperty,
-              justify: colProps.justify,
-              options: filters,
-              onFilter: onFilter
-            }), sortable ? /*#__PURE__*/_jsx(SortControl, {
-              columnKey: rowProperty,
-              onSort: onSort,
-              children: columnText
-            }) : columnText]
-          })
-        }, renderKey);
-      }), expandable && /*#__PURE__*/_jsx(ListCol, {
-        ghost: true,
-        size: "content",
-        children: /*#__PURE__*/_jsx(ExpandControl, {})
-      })]
-    })
+      }, renderKey);
+    }), expandable && /*#__PURE__*/_jsx(ListCol, {
+      ghost: true,
+      size: "content",
+      children: /*#__PURE__*/_jsx(ExpandControl, {})
+    })]
   });
 };
 export const HeaderRow = /*#__PURE__*/memo(TableHeaderRow);

package/dist/DataList/Tables/Rows/TableRow.js

@@ -1,7 +1,6 @@
 import { isValidElement, memo, useCallback, useMemo, createElement as _createElement } from 'react';
 import { Text } from '../../..';
 import { ListCol, ListRow } from '../../../List';
-import { useListContext } from '../../../List/ListProvider';
 import { Shimmer } from '../../../Loading/Shimmer';
 import { ExpandControl, SelectControl } from '../../Controls';
 import { useControlContext } from '../../hooks/useListControls';
@@ -23,13 +22,7 @@ export const TableRow = ({
     onSelect,
     prefixId
   } = useControlContext();
-  const {
-    variant,
-    listType
-  } = useListContext();
-  const dataTablePadding = listType === 'table' && variant === 'table';
   const listColProps = {
-    dataTablePadding,
     showOverflow
   };
   const controlIndices = useMemo(() => {

package/dist/Form/SelectDropdown/styles.d.ts

@@ -1,6 +1,6 @@
 import { theme as GamutTheme } from '@codecademy/gamut-styles';
 import { StylesConfig } from 'react-select';
-export declare const conditionalBorderStates: (props: Partial<Record<"error" | "isFocused" | "activated" | "isDisabled", boolean>> & {
+export declare const conditionalBorderStates: (props: Partial<Record<"error" | "activated" | "isDisabled" | "isFocused", boolean>> & {
     theme?: import("@emotion/react").Theme | undefined;
 }) => import("@codecademy/variance").CSSObject;
 export declare const getMemoizedStyles: (theme: typeof GamutTheme, zIndex?: number) => StylesConfig<any, false>;

package/dist/Form/elements/Form.d.ts

@@ -526,7 +526,7 @@ declare const StyledForm: import("@emotion/styled").StyledComponent<{
     }>;
 } & {
     theme?: import("@emotion/react").Theme | undefined;
-}, Pick<React.DetailedHTMLProps<React.FormHTMLAttributes<HTMLFormElement>, HTMLFormElement>, "name" | "slot" | "style" | "title" | "dir" | "children" | "className" | "aria-hidden" | "onAnimationStart" | "onDragStart" | "onDragEnd" | "onDrag" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "contentEditable" | "contextMenu" | "draggable" | "enterKeyHint" | "hidden" | "id" | "lang" | "nonce" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDragCapture" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "method" | "target" | "acceptCharset" | "action" | "autoComplete" | "encType" | "noValidate" | keyof React.ClassAttributes<HTMLFormElement>>, {}>;
+}, Pick<React.DetailedHTMLProps<React.FormHTMLAttributes<HTMLFormElement>, HTMLFormElement>, "name" | "slot" | "style" | "title" | "dir" | "children" | "className" | "aria-hidden" | "onAnimationStart" | "onDragStart" | "onDragEnd" | "onDrag" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "contentEditable" | "contextMenu" | "draggable" | "enterKeyHint" | "hidden" | "id" | "lang" | "nonce" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDragCapture" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "method" | "target" | "autoComplete" | "acceptCharset" | "action" | "encType" | "noValidate" | keyof React.ClassAttributes<HTMLFormElement>>, {}>;
 export type FormProps = ComponentProps<typeof StyledForm>;
 export declare const Form: React.FC<FormProps>;
 export {};