@gv-tech/ui-core 2.16.0 → 2.17.0

package/README.md

@@ -5,7 +5,7 @@ Shared component contracts, property types, and variants for the GV Tech design
 ## Installation
 
 ```bash
-yarn add @gv-tech/ui-core
+bun add @gv-tech/ui-core
 ```
 
 ## Usage

package/dist/index.d.ts

@@ -865,6 +865,32 @@ export declare interface ScrollBarBaseProps {
     forceMount?: true;
 }
 
+export declare interface ScrollToTopBaseProps {
+    /**
+     * Number of pixels that must be scrolled before the control appears.
+     *
+     * @default 240
+     */
+    threshold?: number;
+    /**
+     * Delay in milliseconds before the page scroll-to-top is triggered,
+     * allowing the exit animation to complete first.
+     *
+     * @default 450
+     */
+    exitDuration?: number;
+    /**
+     * Scroll behavior used when returning to the top.
+     *
+     * @default 'smooth'
+     */
+    behavior?: ScrollBehavior;
+    /** Optional className for custom positioning and styling. */
+    className?: string;
+    /** Accessible label for the control. */
+    label?: string;
+}
+
 export declare interface SearchBaseProps {
     children?: React_2.ReactNode;
     open?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gv-tech/ui-core",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "Shared component contracts (props, variants, sizes) for the GV Tech design system",
   "repository": {
     "type": "git",

package/src/contracts/scroll-to-top.ts

@@ -0,0 +1,25 @@
+export interface ScrollToTopBaseProps {
+  /**
+   * Number of pixels that must be scrolled before the control appears.
+   *
+   * @default 240
+   */
+  threshold?: number;
+  /**
+   * Delay in milliseconds before the page scroll-to-top is triggered,
+   * allowing the exit animation to complete first.
+   *
+   * @default 450
+   */
+  exitDuration?: number;
+  /**
+   * Scroll behavior used when returning to the top.
+   *
+   * @default 'smooth'
+   */
+  behavior?: ScrollBehavior;
+  /** Optional className for custom positioning and styling. */
+  className?: string;
+  /** Accessible label for the control. */
+  label?: string;
+}

package/src/index.ts

@@ -230,6 +230,9 @@ export type {
 // Scroll Area
 export type { ScrollAreaBaseProps, ScrollBarBaseProps } from './contracts/scroll-area';
 
+// Scroll To Top
+export type { ScrollToTopBaseProps } from './contracts/scroll-to-top';
+
 // Search
 export type { SearchBaseProps, SearchTriggerBaseProps } from './contracts/search';