@cube-dev/ui-kit 0.0.0-canary-8781e7c → 0.0.0-canary-642432c

package/es/components/actions/use-action.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 
@@ -35,17 +35,13 @@ export function openLink(href, target) {
     document.body.removeChild(link);
 }
 /**
- * Converts a Path object to a string URL
+ * Checks if a URL is external (absolute HTTP(S), protocol-relative, or non-http protocols)
  */
-function pathToString(path) {
-    let { pathname = '', search = '', hash = '' } = path;
-    if (pathname && !pathname.startsWith('/'))
-        pathname = `/${pathname}`;
-    if (search && !search.startsWith('?'))
-        search = `?${search}`;
-    if (hash && !hash.startsWith('#'))
-        hash = `#${hash}`;
-    return `${pathname}${search}${hash}`;
+function isExternalUrl(url) {
+    return (url.startsWith('http://') ||
+        url.startsWith('https://') ||
+        url.startsWith('//') ||
+        (url.includes(':') && !url.startsWith('#')));
 }
 export function parseTo(to) {
     // Handle number (history navigation)
@@ -53,38 +49,51 @@ export function parseTo(to) {
         return {
             newTab: false,
             nativeRoute: false,
-            href: undefined,
+            cleanTo: undefined,
             isHistoryNavigation: true,
             historyDelta: to,
+            isHashNavigation: false,
+            isExternal: false,
         };
     }
     // Handle object path
     if (to && typeof to === 'object') {
-        const href = pathToString(to);
         return {
             newTab: false,
             nativeRoute: false,
-            href,
+            cleanTo: to,
+            isHistoryNavigation: false,
+            isHashNavigation: false,
+            isExternal: false,
+        };
+    }
+    // Handle string
+    if (!to || typeof to !== 'string') {
+        return {
+            newTab: false,
+            nativeRoute: false,
+            cleanTo: undefined,
             isHistoryNavigation: false,
+            isHashNavigation: false,
+            isExternal: false,
         };
     }
-    // Handle string (existing logic)
-    const newTab = to && typeof to === 'string' && to.startsWith('!');
-    const nativeRoute = to && typeof to === 'string' && to.startsWith('@');
-    const href = to && typeof to === 'string'
-        ? newTab || nativeRoute
-            ? to.slice(1)
-            : to
-        : undefined;
+    const newTab = to.startsWith('!');
+    const nativeRoute = to.startsWith('@');
+    const isHashNavigation = to.startsWith('#');
+    const cleanTo = newTab || nativeRoute ? to.slice(1) : to;
+    const isExternal = typeof cleanTo === 'string' && isExternalUrl(cleanTo);
     return {
-        newTab: !!newTab,
-        nativeRoute: !!nativeRoute,
-        href,
+        newTab,
+        nativeRoute,
+        cleanTo,
         isHistoryNavigation: false,
+        isHashNavigation,
+        isExternal,
     };
 }
-export function performClickHandler(evt, { router, to, onPress, tracking }) {
-    const { newTab, nativeRoute, href, isHistoryNavigation, historyDelta } = parseTo(to);
+export function performClickHandler(evt, { navigate, resolvedHref, to, onPress, tracking, navigationOptions }) {
+    const { newTab, nativeRoute, cleanTo, isHistoryNavigation, historyDelta, isHashNavigation, isExternal, } = parseTo(to);
     const element = evt.target;
     const qa = element?.getAttribute('data-qa');
     onPress?.(evt);
@@ -95,70 +104,98 @@ export function performClickHandler(evt, { router, to, onPress, tracking }) {
     }
     // Handle history navigation (back/forward)
     if (isHistoryNavigation && typeof historyDelta === 'number') {
-        if (router && typeof router.go === 'function') {
-            tracking.event(LINK_PRESS_EVENT, { qa, delta: historyDelta, type: 'router-history' }, element);
-            router.go(historyDelta);
-        }
-        else {
-            tracking.event(LINK_PRESS_EVENT, { qa, delta: historyDelta, type: 'native-history' }, element);
-            window.history.go(historyDelta);
-        }
+        tracking.event(LINK_PRESS_EVENT, { qa, delta: historyDelta, type: 'router-history' }, element);
+        navigate(historyDelta);
         return;
     }
-    if (evt.shiftKey || evt.metaKey || newTab) {
-        openLink(href, true);
-        tracking.event(LINK_PRESS_EVENT, { qa, href, type: 'tab' }, element);
-        return;
-    }
-    if (nativeRoute) {
-        openLink(href || window.location.href);
-        tracking.event(LINK_PRESS_EVENT, { qa, href, type: 'native' }, element);
-    }
-    else if (href && href.startsWith('#')) {
-        const id = href.slice(1);
-        const element = document.getElementById(id);
-        tracking.event(LINK_PRESS_EVENT, { qa, href, type: 'hash', target: id }, element);
-        if (element) {
-            element.scrollIntoView({
+    // Handle hash navigation (smooth scroll)
+    if (isHashNavigation && typeof to === 'string') {
+        const id = to.slice(1);
+        const targetElement = document.getElementById(id);
+        tracking.event(LINK_PRESS_EVENT, { qa, href: to, type: 'hash', target: id }, element);
+        if (targetElement) {
+            targetElement.scrollIntoView({
                 behavior: 'smooth',
                 block: 'start',
                 inline: 'nearest',
             });
-            return;
         }
+        return;
+    }
+    // Handle new tab (via ! prefix or user modifiers)
+    if (evt.shiftKey || evt.metaKey || evt.ctrlKey || newTab) {
+        openLink(resolvedHref, true);
+        tracking.event(LINK_PRESS_EVENT, { qa, href: resolvedHref, type: 'tab' }, element);
+        return;
     }
-    if (router) {
-        tracking.event(LINK_PRESS_EVENT, { qa, href, type: 'router' }, element);
-        // For object paths, pass the original to value; for strings, use href
-        if (typeof to === 'object' && to !== null) {
-            // Modern React Router supports object navigation
-            if (typeof router.navigate === 'function') {
-                router.navigate(to);
-            }
-            else {
-                // Fallback to push with string href for older routers
-                router.push(href);
-            }
+    // Handle @ prefix (native navigation)
+    if (nativeRoute) {
+        if (cleanTo === '' || cleanTo === undefined) {
+            // @'' or @ -> reload current page
+            tracking.event(LINK_PRESS_EVENT, { qa, type: 'native' }, element);
+            window.location.reload();
         }
         else {
-            router.push(href);
+            // @path -> navigate to resolved path natively
+            tracking.event(LINK_PRESS_EVENT, { qa, href: resolvedHref, type: 'native' }, element);
+            window.location.assign(resolvedHref);
         }
+        return;
     }
-    else if (href) {
-        tracking.event(LINK_PRESS_EVENT, { qa, href, type: 'native' }, element);
-        window.location.href = href;
+    // Handle external URLs (always native)
+    if (isExternal && typeof cleanTo === 'string') {
+        tracking.event(LINK_PRESS_EVENT, { qa, href: cleanTo, type: 'native' }, element);
+        window.location.assign(cleanTo);
+        return;
+    }
+    // Handle router navigation
+    if (cleanTo !== undefined) {
+        tracking.event(LINK_PRESS_EVENT, { qa, href: resolvedHref, type: 'router' }, element);
+        navigate(cleanTo, navigationOptions);
     }
 }
-export const useAction = function useAction({ to, as, htmlType, label, mods, onPress, ...props }, ref) {
+export const useAction = function useAction({ to, as, htmlType, label, mods, onPress, navigationOptions, ...props }, ref) {
     const tracking = useTracking();
-    const router = useContext(UIKitContext).router;
+    const navigation = useContext(UIKitContext).navigation;
     const isDisabled = props.isDisabled;
-    const { newTab, href, isHistoryNavigation } = parseTo(to);
+    const { newTab, nativeRoute, cleanTo, isHistoryNavigation, isHashNavigation, isExternal, } = parseTo(to);
+    // Always call navigation hooks (using fallback when to is not provided)
+    const fallbackTo = to || '.';
+    const navigate = navigation.useNavigate();
+    const resolvedHref = navigation.useHref(fallbackTo);
+    // Always resolve cleanTo href to avoid conditional hook calls
+    const cleanToHref = navigation.useHref(cleanTo || '.');
+    // Determine element type: 'a' for navigation, 'button' for actions
     as = to && !isHistoryNavigation ? 'a' : as || 'button';
-    const target = newTab ? '_blank' : undefined;
+    // Compute target (prefixes override explicit target prop per spec)
+    const target = newTab ? '_blank' : props.target;
+    // Compute href for anchor elements
+    let href;
+    if (as === 'a' && cleanTo !== undefined) {
+        if (newTab || nativeRoute) {
+            // For ! and @ prefixes, resolve the clean path
+            href =
+                typeof cleanTo === 'string' && isExternal
+                    ? cleanTo // External URLs as-is
+                    : cleanToHref;
+        }
+        else {
+            // Regular navigation
+            href = resolvedHref;
+        }
+    }
     const domRef = useFocusableRef(ref);
+    // Use navigation options directly
+    const mergedNavigationOptions = navigationOptions;
     const customOnPress = useEvent((evt) => {
-        performClickHandler(evt, { router, to, onPress, tracking });
+        performClickHandler(evt, {
+            navigate,
+            resolvedHref: href || resolvedHref,
+            to,
+            onPress,
+            tracking,
+            navigationOptions: mergedNavigationOptions,
+        });
     });
     let { buttonProps, isPressed } = useButton({
         'aria-label': label,

package/es/components/actions/use-anchored-menu.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/actions/use-context-menu.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/ActiveZone/ActiveZone.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Alert/Alert.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Alert/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Alert/types.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Alert/use-alert.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Avatar/Avatar.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Badge/Badge.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Card/Card.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Content.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/CopyPasteBlock/CopyPasteBlock.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/CopyPasteBlock/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/CopySnippet/CopySnippet.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/CopySnippet/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Divider.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Footer.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Header.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/HotKeys/HotKeys.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/HotKeys/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/ItemBase/ItemBase.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/ItemBase/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/List/SectionHeading.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/List/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Paragraph.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Placeholder/Placeholder.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/PrismCode/PrismCode.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/PrismCode/prismSetup.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/PrismDiffCode/PrismDiffCode.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Result/Result.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Skeleton/Skeleton.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Tag/Tag.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Text.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/content/Title.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/fields/Checkbox/Checkbox.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/fields/Checkbox/CheckboxGroup.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/fields/Checkbox/context.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/fields/Checkbox/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/fields/ComboBox/ComboBox.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */
 

package/es/components/fields/ComboBox/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-8781e7c
+ * @cube-dev/ui-kit v0.0.0-canary-642432c
  * Released under the MIT license.
  */