@hashrytech/quick-components-kit 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @hashrytech/quick-components-kit
 
+## 0.11.0
+
+### Minor Changes
+
+- feat: Adding scroll to action
+
 ## 0.10.0
 
 ### Minor Changes

package/dist/actions/scroll-to.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Svelte action to scroll smoothly to the top, a specific Y position, or a DOM element on click.
+ *
+ * @param node - The element the action is applied to
+ * @param target - Can be:
+ *   - `undefined` → scroll to top
+ *   - `number` → scroll to Y position
+ *   - `string` → interpreted as element ID to scroll to
+ *   - `HTMLElement` → scroll directly to that element
+ */
+export declare function scrollTo(node: HTMLElement, target?: number | string | HTMLElement): {
+    update(newTarget?: number | string | HTMLElement): void;
+    destroy(): void;
+};

package/dist/actions/scroll-to.js

@@ -0,0 +1,39 @@
+/**
+ * Svelte action to scroll smoothly to the top, a specific Y position, or a DOM element on click.
+ *
+ * @param node - The element the action is applied to
+ * @param target - Can be:
+ *   - `undefined` → scroll to top
+ *   - `number` → scroll to Y position
+ *   - `string` → interpreted as element ID to scroll to
+ *   - `HTMLElement` → scroll directly to that element
+ */
+export function scrollTo(node, target) {
+    function handleClick(e) {
+        e.preventDefault();
+        if (typeof target === 'number') {
+            window.scrollTo({ top: target, behavior: 'smooth' });
+        }
+        else if (typeof target === 'string') {
+            const el = document.getElementById(target);
+            if (el)
+                el.scrollIntoView({ behavior: 'smooth' });
+        }
+        else if (target instanceof HTMLElement) {
+            target.scrollIntoView({ behavior: 'smooth' });
+        }
+        else {
+            // Default: scroll to top
+            window.scrollTo({ top: 0, behavior: 'smooth' });
+        }
+    }
+    node.addEventListener('click', handleClick);
+    return {
+        update(newTarget) {
+            target = newTarget;
+        },
+        destroy() {
+            node.removeEventListener('click', handleClick);
+        }
+    };
+}

package/package.json

@@ -5,7 +5,7 @@
     "type": "git",
     "url": "git+https://github.com/hashrytech/quick-components-kit.git"
   },
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "MIT",
   "author": "Hashry Tech",
   "files": [