etudes 32.6.0 → 32.8.0

package/build/primitives/Carousel.d.ts

@@ -15,13 +15,13 @@ import { HTMLAttributes, Ref } from 'react';
  * requirements for landmark regions, pass `aria-label` (or `aria-labelledby`)
  * so the region has an accessible name.
  *
- * @exports Carousel.Viewport Component for the viewport.
  * @exports Carousel.Content Component for the list holding all items.
- * @exports Carousel.ItemContainer Component containing each item.
+ * @exports Carousel.Item Component containing each item.
+ * @exports Carousel.Viewport Component for the viewport.
  * @exports useCarouselItem Hook for reading the current item's index, exposure,
  *                          and active state from within an item's subtree.
  */
-export declare function Carousel({ ref, autoAdvanceInterval, children, dragSpeed, dragStartThreshold, index, orientation, overscrollResistance, swipeLiftWindow, swipeVelocityThreshold, shouldTrackExposure, onAutoAdvancePause, onAutoAdvanceResume, onIndexChange, ...props }: Carousel.Props): import("react").JSX.Element;
+export declare function Carousel({ ref, autoAdvanceInterval, children, dragSpeed, index, orientation, shouldTrackExposure, onAutoAdvancePause, onAutoAdvanceResume, onIndexChange, ...props }: Carousel.Props): import("react").JSX.Element;
 export declare namespace Carousel {
     var displayName: string;
 }
@@ -48,12 +48,6 @@ export declare namespace Carousel {
          * default value is `1`.
          */
         dragSpeed?: number;
-        /**
-         * Minimum pixel distance the pointer must travel between pointer-down and
-         * pointer-up for the gesture to be classified as a drag. Movements within
-         * this threshold are treated as a click and are allowed to propagate.
-         */
-        dragStartThreshold?: number;
         /**
          * Current item index.
          */
@@ -62,32 +56,11 @@ export declare namespace Carousel {
          * Orientation of the carousel.
          */
         orientation?: Orientation;
-        /**
-         * Resistance applied when the user drags past the first or last item. `0`
-         * lets the overshoot track the pointer 1:1 (no resistance); `1` clamps hard
-         * at the boundary (max resistance, no overshoot). Values in between produce
-         * a rubber-band effect—higher means more resistance.
-         */
-        overscrollResistance?: number;
         /**
          * Whether to track item exposure (0-1, 0 meaning the item is fully scrolled
          * out of view, 1 meaning the item is fully scrolled into view).
          */
         shouldTrackExposure?: boolean;
-        /**
-         * Maximum gap in milliseconds between the last pointer move and the pointer
-         * release for the gesture to register as a swipe. If the pointer was held
-         * stationary longer than this before release, no swipe is detected and the
-         * release falls back to position-based snapping.
-         */
-        swipeLiftWindow?: number;
-        /**
-         * Minimum axial pointer velocity (in pixels per millisecond) at release for
-         * the gesture to register as a swipe. A detected swipe advances the index
-         * by one in the swipe direction, regardless of how far the displacement has
-         * traveled.
-         */
-        swipeVelocityThreshold?: number;
         /**
          * Handler invoked when auto advance pauses. This is invoked only when
          * {@link autoAdvanceInterval} is greater than 0.
@@ -135,7 +108,7 @@ export declare namespace Carousel {
     /**
      * Component containing each item in a {@link Carousel}.
      */
-    const ItemContainer: {
+    const Item: {
         ({ children, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
         displayName: string;
     };

package/build/primitives/TextArea.d.ts

@@ -8,13 +8,17 @@ export declare namespace TextArea {
          * Reference to the root element.
          */
         ref?: Ref<HTMLTextAreaElement>;
+        /**
+         * Specifies if the text area should be focused when it is mounted.
+         */
+        autoFocus?: boolean;
         onChange: (value: string) => void;
-    } & Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange'>;
+    } & Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'autoFocus' | 'onChange'>;
 }
 /**
  * A text area component that allows the user to enter multiple lines of text.
  */
-export declare function TextArea({ ref, onChange, ...props }: TextArea.Props): import("react").JSX.Element;
+export declare function TextArea({ ref, autoFocus, onChange, ...props }: TextArea.Props): import("react").JSX.Element;
 export declare namespace TextArea {
     var displayName: string;
 }

package/build/primitives/TextField.d.ts

@@ -8,6 +8,10 @@ export declare namespace TextField {
          * Reference to the root element.
          */
         ref?: Ref<HTMLInputElement>;
+        /**
+         * Specifies if the text field should be focused when it is mounted.
+         */
+        autoFocus?: boolean;
         /**
          * The value to set to when the text field is empty.
          */
@@ -39,7 +43,7 @@ export declare namespace TextField {
          *
          * @returns The formatted value.
          */
-        formatter?: (value: string) => string;
+        formatValue?: (value: string) => string;
         /**
          * Handler invoked the text field is focused.
          *
@@ -58,12 +62,12 @@ export declare namespace TextField {
          * @param value The new value of the text field.
          */
         onChange?: (value: string) => void;
-    } & Omit<InputHTMLAttributes<HTMLInputElement>, 'aria-disabled' | 'aria-placeholder' | 'aria-required' | 'disabled' | 'onBlur' | 'onChange' | 'onFocus' | 'placeholder' | 'required' | 'type' | 'value'>;
+    } & Omit<InputHTMLAttributes<HTMLInputElement>, 'aria-disabled' | 'aria-placeholder' | 'aria-required' | 'autoFocus' | 'disabled' | 'onBlur' | 'onChange' | 'onFocus' | 'placeholder' | 'required' | 'type' | 'value'>;
 }
 /**
  * A text field that supports custom value formatting and empty value.
  */
-export declare function TextField({ className, ref, emptyValue, formatter, placeholder, type, value, isDisabled, isRequired, onChange, onFocus, onUnfocus, ...props }: TextField.Props): import("react").JSX.Element;
+export declare function TextField({ className, ref, autoFocus, emptyValue, placeholder, type, value, isDisabled, isRequired, formatValue, onChange, onFocus, onUnfocus, ...props }: TextField.Props): import("react").JSX.Element;
 export declare namespace TextField {
     var displayName: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "etudes",
-  "version": "32.6.0",
+  "version": "32.8.0",
   "description": "A study of headless React components",
   "type": "module",
   "sideEffects": false,
@@ -43,33 +43,33 @@
   "author": "Andrew Wei <andrewscwei@gmail.com>",
   "license": "MIT",
   "devDependencies": {
-    "@commitlint/config-conventional": "^21.0.2",
+    "@commitlint/config-conventional": "^21.2.0",
     "@eslint/js": "^10.0.1",
     "@semantic-release/git": "^10.0.1",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@tailwindcss/vite": "^4.3.1",
+    "@tailwindcss/vite": "^4.3.2",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
-    "@types/node": "^25.9.3",
+    "@types/node": "^26.1.0",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^6.0.2",
-    "@vitest/coverage-v8": "^4.1.9",
+    "@vitejs/plugin-react": "^6.0.3",
+    "@vitest/coverage-v8": "^4.1.10",
     "concurrently": "^10.0.3",
-    "eslint": "^10.5.0",
+    "eslint": "^10.6.0",
     "eslint-plugin-perfectionist": "^5.9.1",
-    "happy-dom": "^20.10.5",
+    "happy-dom": "^20.10.6",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "rimraf": "^6.1.3",
     "semantic-release": "^25.0.5",
-    "tailwindcss": "^4.3.1",
+    "tailwindcss": "^4.3.2",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.61.1",
-    "vite": "^8.0.16",
-    "vite-plugin-dts": "^5.0.2",
+    "typescript-eslint": "^8.62.1",
+    "vite": "^8.1.3",
+    "vite-plugin-dts": "^5.0.3",
     "vite-plugin-svgr": "^5.2.0",
-    "vitest": "^4.1.9",
+    "vitest": "^4.1.10",
     "wait-on": "^9.0.10"
   },
   "dependencies": {