@placeholderco/placeholder-ui 3.0.2 → 3.0.3

package/dist/ui/Button.svelte

@@ -28,6 +28,10 @@
 		iconSize?: string;
 		/** Link target attribute (when href is provided) */
 		target?: undefined | '_self' | '_blank';
+		/** Relationship attribute (when href is provided). `rel="external"` skips client-side navigation */
+		rel?: string;
+		/** Download the linked URL instead of navigating (when href is provided). `true` keeps the server's filename */
+		download?: boolean | string;
 		/** Button type attribute (when rendered as a button, not a link) */
 		type?: 'button' | 'submit' | 'reset';
 		/** Additional CSS classes */
@@ -51,6 +55,8 @@
 		rightSvg = undefined,
 		iconSize = '18px',
 		target = undefined,
+		rel = undefined,
+		download = undefined,
 		type = 'button',
 		class: buttonClass = '',
 		children,
@@ -89,6 +95,8 @@
 {#if isLink && href && !disabled}
 	<a
 		{target}
+		{rel}
+		download={download === true ? '' : download || undefined}
 		class={elClass}
 		aria-label={ariaLabel}
 		href={href?.startsWith('/') ? resolve(href as any) : href}

package/dist/ui/Button.svelte.d.ts

@@ -22,6 +22,10 @@ export interface ButtonProps {
     iconSize?: string;
     /** Link target attribute (when href is provided) */
     target?: undefined | '_self' | '_blank';
+    /** Relationship attribute (when href is provided). `rel="external"` skips client-side navigation */
+    rel?: string;
+    /** Download the linked URL instead of navigating (when href is provided). `true` keeps the server's filename */
+    download?: boolean | string;
     /** Button type attribute (when rendered as a button, not a link) */
     type?: 'button' | 'submit' | 'reset';
     /** Additional CSS classes */

package/dist/ui/Link.svelte

@@ -10,6 +10,8 @@
 		rel?: string;
 		/** Link target attribute */
 		target?: '_self' | '_blank' | undefined;
+		/** Download the linked URL instead of navigating. `true` keeps the server's filename */
+		download?: boolean | string;
 		/** Additional CSS classes */
 		class?: string;
 		/** Link content */
@@ -24,6 +26,7 @@
 		href,
 		rel = '',
 		target = undefined,
+		download = undefined,
 		class: classes = '',
 		children,
 		onclick,
@@ -36,6 +39,7 @@
 	class={classes}
 	href={href?.startsWith('/') ? resolve(href as any) : href}
 	{rel}
+	download={download === true ? '' : download || undefined}
 	aria-current={ariaCurrent}
 	onclick={(e) => interceptLinkClick(e, { href, target, onclick })}
 	data-sveltekit-preload-data="hover"

package/dist/ui/Link.svelte.d.ts

@@ -6,6 +6,8 @@ export interface LinkProps {
     rel?: string;
     /** Link target attribute */
     target?: '_self' | '_blank' | undefined;
+    /** Download the linked URL instead of navigating. `true` keeps the server's filename */
+    download?: boolean | string;
     /** Additional CSS classes */
     class?: string;
     /** Link content */

package/dist/ui/Table.svelte

@@ -242,7 +242,7 @@
 		if (href) {
 			event.preventDefault();
 			if (newTabIntent) window.open(href, '_blank', 'noopener');
-			else navigateTo(href);
+			else navigateTo(href).catch(console.error);
 		}
 	}
 

package/dist/util/NavigateTo.d.ts

@@ -1 +1,6 @@
-export declare function navigateTo(url: string): void;
+/**
+ * Navigates client-side when the URL is a page route in the app. URLs the client router can't
+ * reach (`+server.ts` endpoints, static files, external URLs) fall back to a full browser
+ * navigation. Cancelled navigations resolve quietly; any other failure rejects.
+ */
+export declare function navigateTo(url: string): Promise<void>;

package/dist/util/NavigateTo.js

@@ -1,5 +1,27 @@
 import { goto } from '$app/navigation';
 import { resolve } from '$app/paths';
-export function navigateTo(url) {
-    goto(resolve(url));
+// SvelteKit puts the error code in the message in both dev and prod builds
+const FALLBACK_ERRORS = ['/e/kit/navigation_route_missing', '/e/kit/navigation_external_url'];
+// Rejections for navigations superseded by another one, or cancelled via beforeNavigate
+const CANCELLED_ERRORS = ['navigation cancelled', 'navigation aborted'];
+/**
+ * Navigates client-side when the URL is a page route in the app. URLs the client router can't
+ * reach (`+server.ts` endpoints, static files, external URLs) fall back to a full browser
+ * navigation. Cancelled navigations resolve quietly; any other failure rejects.
+ */
+export async function navigateTo(url) {
+    const resolved = resolve(url);
+    try {
+        await goto(resolved);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (FALLBACK_ERRORS.some((code) => message.includes(code))) {
+            window.location.assign(resolved);
+            return;
+        }
+        if (CANCELLED_ERRORS.includes(message))
+            return;
+        throw error;
+    }
 }

package/dist/util/interceptLinkClick.js

@@ -26,8 +26,25 @@ export function interceptLinkClick(event, options) {
     if (event.button !== 0) {
         return;
     }
+    // Honour SvelteKit's standard opt-outs from client-side navigation
+    const anchor = event.currentTarget instanceof HTMLAnchorElement ? event.currentTarget : null;
+    if (anchor && isClientNavOptOut(anchor)) {
+        return;
+    }
     // Prevent default navigation and use SvelteKit's client-side navigation
     event.preventDefault();
-    if (href)
-        navigateTo(href);
+    navigateTo(href).catch((error) => {
+        console.error(error);
+        // The click must still go somewhere, as a plain anchor would
+        window.location.assign(anchor?.href ?? href);
+    });
+}
+/** `download`, `rel="external"` and `data-sveltekit-reload` (on the link or an ancestor) */
+function isClientNavOptOut(anchor) {
+    if (anchor.hasAttribute('download'))
+        return true;
+    if (anchor.relList.contains('external'))
+        return true;
+    const reload = anchor.closest('[data-sveltekit-reload]')?.getAttribute('data-sveltekit-reload');
+    return reload != null && reload !== 'off';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@placeholderco/placeholder-ui",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "A modern, customizable Svelte 5 UI component library with comprehensive theming support. Re-brand it with a single config object.",
   "license": "MIT",
   "author": "Placeholderco",