@valentinkolb/cloud 0.4.0 → 0.5.0

package/src/ui/toast.ts

@@ -0,0 +1,384 @@
+/**
+ * Toast — transient bottom-right notifications, Mantine-style.
+ *
+ * Sits next to `prompts` as the platform's lightweight messaging
+ * surface: where `prompts.alert/confirm/form` are blocking modals,
+ * `toast()` is fire-and-forget feedback that the user doesn't have
+ * to dismiss.
+ *
+ * API shape
+ * ---------
+ * The first positional arg is the **description** (the body line);
+ * the title defaults to the variant name ("Info" / "Success" /
+ * "Error") and can be overridden via `options.title`. Rationale:
+ * for the 95 % case ("just tell the user something happened") the
+ * default title is fine, and the desc is what carries the actual
+ * information. Spelling out a custom title is opt-in.
+ *
+ * Visual language
+ * ---------------
+ * White card body on a soft float, neutral zinc title, dimmed gray
+ * description. The variant signal lives in a leading soft-tinted disc
+ * with a colour-matched icon (the elevated, low-shout treatment from
+ * the redesign — a faint wash rather than a loud saturated fill):
+ *   - `default` → soft blue disc with info icon
+ *   - `success` → soft green disc with check icon
+ *   - `error`   → soft red disc with X icon
+ *
+ * Dark mode mirrors with `zinc-900` body, lighter zinc text; the disc
+ * tint + icon colour shift to the lighter 400-tones so the variant
+ * still reads at a glance against the dark surface.
+ *
+ * Every toast in the stack renders at the same fixed width
+ * (`TOAST_WIDTH_CLASS`) so they line up neatly when stacked.
+ *
+ * Usage
+ * -----
+ * ```ts
+ * import { toast } from "@valentinkolb/cloud/ui";
+ *
+ * toast("All changes synced");                           // title "Info"
+ * toast("All changes synced", { title: "Saved" });
+ * toast.success("Untitled-3 created");                   // title "Success"
+ * toast.error("Network unreachable");                    // title "Error"
+ * toast.error("Network unreachable", { title: "Bummer!", duration: 5000 });
+ *
+ * const t = toast("0%", { title: "Uploading", duration: 0 });
+ * t.update("50%");
+ * t.update("Everything fine", { variant: "success", title: "Done", duration: 2000 });
+ *
+ * toast.dismissAll();
+ * ```
+ *
+ * SSR-safe: every entry point bails when `document` is unavailable.
+ */
+
+export type ToastVariant = "default" | "success" | "error";
+
+export type ToastOptions = {
+  /** Visual style. Default `"default"` (blue left-bar). */
+  variant?: ToastVariant;
+  /** Auto-dismiss after this many ms. Default `3000`. `0` = sticky
+   *  (only manual `t.dismiss()` removes it). */
+  duration?: number;
+  /** `ti-…` icon class to override the variant default. Only
+   *  applies to `success` / `error` variants — the `default`
+   *  variant doesn't render an icon. */
+  iconClass?: string;
+  /** Override the variant default title (`"Info"` / `"Success"` /
+   *  `"Error"`). Pass any string — `""` renders an empty title row. */
+  title?: string;
+};
+
+export type ToastHandle = {
+  /** Animate out and remove. No-op if already dismissed. */
+  dismiss: () => void;
+  /**
+   * Mutate the visible toast in place. Only present option keys
+   * change; missing keys leave the existing values alone.
+   *  - `update("X")` → desc becomes "X", everything else unchanged
+   *  - `update("X", { title: "Saved" })` → desc + title both update
+   *  - `update("X", { variant: "success" })` → swaps the leading
+   *    element (bar ↔ circle) AND swaps the title to the new
+   *    variant default unless `title` is explicitly passed
+   *
+   * The auto-dismiss timer resets to the (new or existing)
+   * `duration` so a near-expired toast doesn't disappear right
+   * after a fresh update.
+   */
+  update: (description: string, options?: ToastOptions) => void;
+};
+
+export interface ToastFn {
+  (description: string, options?: ToastOptions): ToastHandle;
+  success: (description: string, options?: Omit<ToastOptions, "variant">) => ToastHandle;
+  error: (description: string, options?: Omit<ToastOptions, "variant">) => ToastHandle;
+  /** Dismiss every currently visible toast. Useful for route
+   *  changes / major UI transitions where stale notifications are
+   *  confusing. */
+  dismissAll: () => void;
+}
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+const DEFAULT_DURATION_MS = 3000;
+const MAX_VISIBLE_TOASTS = 5;
+const ANIMATION_MS = 200;
+const CONTAINER_ID = "ui-toast-container";
+
+/** Fixed width for every toast — all toasts in the stack line up at
+ *  this exact width regardless of content length. `w-80` = 20 rem ≈
+ *  320 px; intentionally narrower than Mantine's default so toasts
+ *  don't dominate the right rail. To make this configurable later,
+ *  lift to an option. */
+const TOAST_WIDTH_CLASS = "w-80";
+
+/** Per-variant rendering recipe. The lead element is a 36 px soft-tinted
+ *  disc with a colour-matched icon — a faint wash (`/10`–`/15` alpha)
+ *  rather than a saturated fill, so it reads as elevated rather than
+ *  shouty. Tint + icon colour shift to the 400-tones in dark mode so
+ *  the variant signal survives the theme flip. */
+type VariantStyle = {
+  /** Tailwind classes for the disc's soft-tinted background (light + dark). */
+  circleBgClass: string;
+  /** Tailwind classes for the icon colour inside the disc (light + dark). */
+  iconColorClass: string;
+  /** Default `ti-…` class for the disc's icon. Overridable via
+   *  `options.iconClass`. */
+  iconClass: string;
+  /** Default title shown when `options.title` is not set. */
+  defaultTitle: string;
+};
+
+const VARIANT_STYLES: Record<ToastVariant, VariantStyle> = {
+  default: {
+    circleBgClass: "bg-blue-500/10 dark:bg-blue-400/15",
+    iconColorClass: "text-blue-600 dark:text-blue-400",
+    iconClass: "ti-info-circle",
+    defaultTitle: "Info",
+  },
+  success: {
+    circleBgClass: "bg-green-500/15 dark:bg-green-400/15",
+    iconColorClass: "text-green-600 dark:text-green-400",
+    iconClass: "ti-check",
+    defaultTitle: "Success",
+  },
+  error: {
+    circleBgClass: "bg-red-500/15 dark:bg-red-400/15",
+    iconColorClass: "text-red-600 dark:text-red-400",
+    iconClass: "ti-x",
+    defaultTitle: "Error",
+  },
+};
+
+const splitClasses = (cls: string): string[] => cls.split(/\s+/).filter(Boolean);
+
+// All currently-mounted toasts. Used for `dismissAll`.
+const liveToasts = new Set<ToastHandle>();
+
+// =============================================================================
+// Container
+// =============================================================================
+
+/** Lazily-mount the fixed-position container. Idempotent. */
+const ensureContainer = (): HTMLElement | null => {
+  if (typeof document === "undefined") return null;
+  let container = document.getElementById(CONTAINER_ID);
+  if (container) return container;
+  container = document.createElement("div");
+  container.id = CONTAINER_ID;
+  container.className =
+    // Container sits flush bottom-right with a small offset; toasts
+    // stack vertically with `gap-2`. No max-width or items-end — the
+    // toasts have their own fixed width and naturally align right
+    // because the container itself is right-anchored.
+    "fixed bottom-4 right-4 z-50 flex flex-col gap-2 " +
+    // The gaps between toasts shouldn't intercept clicks on the page
+    // beneath. Each toast re-enables pointer-events on itself.
+    "pointer-events-none";
+  document.body.appendChild(container);
+  return container;
+};
+
+// =============================================================================
+// Internals — element construction + style swap
+// =============================================================================
+
+/** Strip every variant's disc-tint classes from an element. Used in
+ *  the variant swap path so repeated `update()` calls don't
+ *  accumulate stacked palettes. */
+const stripAllLeadBg = (el: HTMLElement): void => {
+  for (const v of Object.values(VARIANT_STYLES)) {
+    for (const cls of splitClasses(v.circleBgClass)) el.classList.remove(cls);
+  }
+};
+
+/** Reset an element's classes to a fresh class list. Used so swap
+ *  logic doesn't have to track what was there before. */
+const setClasses = (el: HTMLElement, cls: string): void => {
+  el.className = cls;
+};
+
+/** Build / rebuild the lead element (the leftmost variant signal): a
+ *  36 px soft-tinted disc containing a colour-matched `<i>` icon. On
+ *  variant swap we replace the disc's children + classes wholesale
+ *  rather than morph in place.
+ *
+ *  Returns the icon element so the caller can override the icon-class
+ *  later via `update({ iconClass: ... })`. */
+const renderLead = (
+  leadEl: HTMLElement,
+  variant: ToastVariant,
+  iconClassOverride?: string,
+): HTMLElement => {
+  const style = VARIANT_STYLES[variant];
+  leadEl.replaceChildren();
+  setClasses(
+    leadEl,
+    "shrink-0 self-start w-9 h-9 rounded-full flex items-center justify-center",
+  );
+  for (const cls of splitClasses(style.circleBgClass)) leadEl.classList.add(cls);
+  const iconEl = document.createElement("i");
+  iconEl.className = `ti ${iconClassOverride ?? style.iconClass} ${style.iconColorClass} text-base`;
+  leadEl.appendChild(iconEl);
+  return iconEl;
+};
+
+// =============================================================================
+// Public API
+// =============================================================================
+
+const showToast = (description: string, options?: ToastOptions): ToastHandle => {
+  const container = ensureContainer();
+  if (!container) {
+    const noop = () => {};
+    return { dismiss: noop, update: noop };
+  }
+
+  let dismissed = false;
+  let dismissTimer: ReturnType<typeof setTimeout> | null = null;
+  let currentVariant: ToastVariant = options?.variant ?? "default";
+
+  // ----- DOM scaffolding -----
+
+  // Toast card. White / zinc-900 body, neutral text, soft shadow,
+  // no border (the lead element is the only color affordance).
+  // Fixed width so every toast in the stack lines up. Click-anywhere
+  // dismisses — there's no explicit close button.
+  const toastEl = document.createElement("div");
+  toastEl.className =
+    `pointer-events-auto cursor-pointer flex items-stretch gap-3 ${TOAST_WIDTH_CLASS} ` +
+    "p-3 rounded-md [box-shadow:var(--theme-shadow-float)] " +
+    "bg-white dark:bg-zinc-900 " +
+    "transition-all duration-200 ease-out " +
+    // Initial off-screen state — flipped on the next frame so the
+    // browser renders the entry frame and animates the change.
+    "translate-x-2 opacity-0";
+
+  const leadEl = document.createElement("div");
+  let leadIconEl = renderLead(leadEl, currentVariant, options?.iconClass);
+
+  // Content column — title + description.
+  const contentEl = document.createElement("div");
+  contentEl.className = "flex-1 min-w-0 self-center flex flex-col gap-0.5";
+
+  // Title — variant default ("Info" / "Success" / "Error") unless
+  // overridden via `options.title`. Subtle weight + tone — toasts
+  // are peripheral feedback and loud body text reads as alert.
+  const titleEl = document.createElement("div");
+  titleEl.className = "text-sm font-medium text-zinc-800 dark:text-zinc-200 leading-tight";
+  titleEl.textContent = options?.title ?? VARIANT_STYLES[currentVariant].defaultTitle;
+
+  // Description (the positional first arg).
+  const descEl = document.createElement("div");
+  descEl.className = "text-xs text-zinc-500 dark:text-zinc-400 leading-snug";
+  descEl.textContent = description;
+
+  contentEl.appendChild(titleEl);
+  contentEl.appendChild(descEl);
+
+  toastEl.appendChild(leadEl);
+  toastEl.appendChild(contentEl);
+
+  // ----- timer + dismiss -----
+
+  const clearDismissTimer = () => {
+    if (dismissTimer !== null) {
+      clearTimeout(dismissTimer);
+      dismissTimer = null;
+    }
+  };
+
+  const armDismissTimer = (duration: number) => {
+    clearDismissTimer();
+    if (duration > 0) {
+      dismissTimer = setTimeout(() => dismiss(), duration);
+    }
+    // duration === 0 → sticky; rely on manual dismiss / dismissAll.
+  };
+
+  const dismiss = () => {
+    if (dismissed) return;
+    dismissed = true;
+    clearDismissTimer();
+    liveToasts.delete(handle);
+    toastEl.classList.remove("translate-x-0", "opacity-100");
+    toastEl.classList.add("translate-x-2", "opacity-0");
+    setTimeout(() => toastEl.remove(), ANIMATION_MS);
+  };
+
+  const update = (nextDescription: string, nextOptions?: ToastOptions) => {
+    if (dismissed) return;
+
+    // Description is positional and always replaces.
+    descEl.textContent = nextDescription;
+
+    // Variant swap: re-render the lead element wholesale (bar↔circle
+    // is a DOM-shape change). Strip stale bg classes first so we
+    // don't blend the previous variant's tint into the new one.
+    const variantChanged = nextOptions?.variant !== undefined && nextOptions.variant !== currentVariant;
+    if (variantChanged) {
+      currentVariant = nextOptions.variant!;
+      stripAllLeadBg(leadEl);
+      leadIconEl = renderLead(leadEl, currentVariant, nextOptions.iconClass);
+    } else if (nextOptions?.iconClass !== undefined && leadIconEl) {
+      // Same variant, new iconClass — just swap the modifier on the
+      // existing icon node. Only meaningful for circle variants.
+      for (const cls of Array.from(leadIconEl.classList)) {
+        if (cls.startsWith("ti-")) leadIconEl.classList.remove(cls);
+      }
+      leadIconEl.classList.add(nextOptions.iconClass);
+    }
+
+    // Title:
+    //  - explicit `options.title` always wins (incl. `""` for empty)
+    //  - else if variant changed, follow the new variant's default
+    //    so a `update("...", { variant: "success" })` flips both bar
+    //    and title to "Success" without forcing the caller to spell
+    //    out the title string
+    //  - else leave the title as-is
+    if (nextOptions && Object.prototype.hasOwnProperty.call(nextOptions, "title")) {
+      titleEl.textContent = nextOptions.title ?? "";
+    } else if (variantChanged) {
+      titleEl.textContent = VARIANT_STYLES[currentVariant].defaultTitle;
+    }
+
+    armDismissTimer(nextOptions?.duration ?? DEFAULT_DURATION_MS);
+  };
+
+  toastEl.addEventListener("click", dismiss);
+
+  const handle: ToastHandle = { dismiss, update };
+  liveToasts.add(handle);
+
+  // ----- mount + animate in -----
+
+  // Cap the visible stack BEFORE we add the new toast so the
+  // overflow-removal doesn't visually flicker the new arrival.
+  while (container.children.length >= MAX_VISIBLE_TOASTS) {
+    container.firstElementChild?.remove();
+  }
+  container.appendChild(toastEl);
+
+  requestAnimationFrame(() => {
+    toastEl.classList.remove("translate-x-2", "opacity-0");
+    toastEl.classList.add("translate-x-0", "opacity-100");
+  });
+
+  armDismissTimer(options?.duration ?? DEFAULT_DURATION_MS);
+
+  return handle;
+};
+
+const toastFn = ((description: string, options?: ToastOptions) => showToast(description, options)) as ToastFn;
+
+toastFn.success = (description, options) => showToast(description, { ...options, variant: "success" });
+toastFn.error = (description, options) => showToast(description, { ...options, variant: "error" });
+toastFn.dismissAll = () => {
+  // Snapshot — `dismiss()` mutates `liveToasts`.
+  for (const handle of Array.from(liveToasts)) handle.dismiss();
+};
+
+export const toast: ToastFn = toastFn;

package/src/ui/widgets/Widget.tsx

@@ -26,12 +26,18 @@ type WidgetProps = {
 };
 
 const Widget = (props: WidgetProps): JSX.Element => {
-  const headerClass = `flex items-center gap-2 px-4 py-2.5 border-b border-zinc-100 dark:border-zinc-800 ${
-    props.href ? "hover:bg-zinc-50 dark:hover:bg-zinc-800/40 transition-colors" : ""
+  // Header reads as a tinted band (colour, not a divider line) so it separates
+  // from the white body without a hairline. The link variant darkens on hover.
+  const headerClass = `flex items-center gap-2 px-4 py-2.5 bg-zinc-50 dark:bg-zinc-800/40 ${
+    props.href ? "hover:bg-zinc-100 dark:hover:bg-zinc-800/70 transition-colors" : ""
   }`;
   const headerInner = (
     <>
-      {props.icon ? <i class={`${props.icon} text-dimmed text-sm shrink-0`} /> : null}
+      {props.icon ? (
+        <span class="grid h-7 w-7 shrink-0 place-items-center rounded-lg bg-blue-500/10 text-blue-600 dark:bg-blue-400/15 dark:text-blue-400">
+          <i class={`${props.icon} text-sm`} />
+        </span>
+      ) : null}
       <span class="text-xs font-semibold uppercase tracking-wider text-secondary truncate">
         {props.title}
       </span>
@@ -52,7 +58,9 @@ const Widget = (props: WidgetProps): JSX.Element => {
       ) : (
         <div class={headerClass}>{headerInner}</div>
       )}
-      <div class="flex-1 flex flex-col divide-y divide-zinc-100 dark:divide-zinc-800 min-h-0">
+      {/* Blocks separate by their own padding + tinted blocks (e.g. WidgetStatus)
+          carrying their own background — no hairline dividers. */}
+      <div class="flex-1 flex flex-col min-h-0">
         {props.children}
       </div>
     </div>

package/src/ssr/MoreAppsDropdown.island.tsx

@@ -1,61 +0,0 @@
-import { Dropdown } from "../ui";
-
-type AppLink = {
-  iconClass: string;
-  label: string;
-  href: string;
-};
-
-type LegalLink = {
-  label: string;
-  href: string;
-  icon?: string;
-};
-
-type MoreAppsDropdownProps = {
-  apps: AppLink[];
-  /**
-   * Legal/info links contributed by every running app via `defineApp.legalLinks`.
-   * Computed server-side via `listLegalLinks()` (or the runtime aggregation in
-   * Layout.tsx) and passed in as a prop. Empty array = section hidden.
-   */
-  legalLinks?: LegalLink[];
-};
-
-/** Dropdown for secondary apps in the rail nav. */
-export default function MoreAppsDropdown(props: MoreAppsDropdownProps) {
-  const legalLinks = props.legalLinks ?? [];
-  const trigger = (
-    <span class="rail-item" title="More">
-      <i class="ti ti-dots-vertical text-base" />
-    </span>
-  );
-
-  const appItems = props.apps.map((app) => ({
-    icon: app.iconClass,
-    label: app.label,
-    href: app.href,
-  }));
-
-  const legalItems = legalLinks.map((link) => ({
-    icon: link.icon ?? "ti ti-file-text",
-    label: link.label,
-    href: link.href,
-  }));
-
-  const elements = legalItems.length > 0
-    ? [
-        ...(appItems.length > 0 ? [{ items: appItems }] : []),
-        { sectionLabel: "Legal", items: legalItems },
-      ]
-    : appItems;
-
-  return (
-    <Dropdown
-      trigger={trigger}
-      elements={elements}
-      position="bottom-right"
-      width="w-44"
-    />
-  );
-}

package/src/ui/ipa/GroupView.tsx

@@ -1,36 +0,0 @@
-import type { BaseGroup } from "../../contracts/shared";
-
-type GroupViewProps = {
-  group: BaseGroup;
-  canManage?: boolean;
-};
-
-export default function GroupView(props: GroupViewProps) {
-  return (
-    <div class="flex items-start gap-3 min-w-0">
-      <div class="flex shrink-0 items-center justify-center rounded-full bg-zinc-200 dark:bg-zinc-700 text-zinc-600 dark:text-zinc-300 h-9 w-9">
-        <i class="ti ti-users-group text-base" />
-      </div>
-      <div class="flex flex-col gap-0.5 min-w-0">
-        <div class="flex items-center gap-2">
-          <span class="text-sm font-medium text-primary truncate">{props.group.name}</span>
-          {props.group.gidnumber && (
-            <span class="tag bg-emerald-100 dark:bg-emerald-900/50 text-emerald-700 dark:text-emerald-300 shrink-0">
-              POSIX {props.group.gidnumber}
-            </span>
-          )}
-          {props.canManage && (
-            <span
-              class="tag bg-blue-100 dark:bg-blue-900/50 text-blue-700 dark:text-blue-300 shrink-0"
-              title="You can manage this group"
-            >
-              <i class="ti ti-shield text-xs" />
-              MANAGER
-            </span>
-          )}
-        </div>
-        <span class="text-xs text-dimmed truncate">{props.group.description || "No description"}</span>
-      </div>
-    </div>
-  );
-}

package/src/ui/ipa/LoginBtn.tsx

@@ -1,16 +0,0 @@
-type LoginBtnProps = {
-  redirectTo?: string;
-  class?: string;
-};
-
-/** Link styled as a button that navigates to the login page. */
-export default function LoginBtn(props: LoginBtnProps) {
-  const href = props.redirectTo ? `/auth/login?redirectTo=${encodeURIComponent(props.redirectTo)}` : "/auth/login";
-
-  return (
-    <a href={href} class={props.class ?? "btn-primary"}>
-      <i class="ti ti-login" />
-      <span>Sign In</span>
-    </a>
-  );
-}

package/src/ui/ipa/UserView.tsx

@@ -1,58 +0,0 @@
-import type { BaseUser } from "../../contracts/shared";
-
-type UserViewProps = {
-  user: BaseUser;
-  showRealm?: boolean;
-};
-
-const badgeStyles: Record<`${"ipa" | "local"}:${"user" | "guest"}`, { bg: string; text: string; label: string }> = {
-  "ipa:user": {
-    bg: "bg-green-100 dark:bg-green-900/30",
-    text: "text-green-700 dark:text-green-400",
-    label: "IPA",
-  },
-  "ipa:guest": {
-    bg: "bg-yellow-100 dark:bg-yellow-900/30",
-    text: "text-yellow-700 dark:text-yellow-400",
-    label: "IPA Guest",
-  },
-  "local:user": {
-    bg: "bg-sky-100 dark:bg-sky-900/30",
-    text: "text-sky-700 dark:text-sky-400",
-    label: "Local",
-  },
-  "local:guest": {
-    bg: "bg-zinc-100 dark:bg-zinc-800",
-    text: "text-zinc-600 dark:text-zinc-400",
-    label: "Guest",
-  },
-};
-
-export default function UserView(props: UserViewProps) {
-  const badge = () => badgeStyles[`${props.user.provider}:${props.user.profile}`] ?? badgeStyles["local:guest"];
-
-  return (
-    <div class="flex items-start gap-3 min-w-0">
-      <div class="flex shrink-0 items-center justify-center rounded-full bg-zinc-200 dark:bg-zinc-700 font-semibold text-zinc-600 dark:text-zinc-300 h-9 w-9 text-xs">
-        {props.user.uid.slice(0, 2).toUpperCase()}
-      </div>
-      <div class="flex flex-col gap-0.5 min-w-0">
-        <div class="flex items-center gap-2">
-          <span class="text-sm font-medium text-primary truncate">{props.user.displayName}</span>
-          {props.showRealm && badge() !== undefined && (
-            <span class={`tag ${badge()?.bg} ${badge()?.text}`}>{badge()?.label}</span>
-          )}
-        </div>
-        <div class="flex items-center gap-2 text-xs text-dimmed">
-          <span class="font-mono">{props.user.profile === "guest" ? `${props.user.uid.slice(0, 12)}...` : props.user.uid}</span>
-          {props.user.mail && (
-            <>
-              <span class="text-zinc-300 dark:text-zinc-600">|</span>
-              <span class="truncate">{props.user.mail}</span>
-            </>
-          )}
-        </div>
-      </div>
-    </div>
-  );
-}

package/src/ui/ipa/index.ts

@@ -1,4 +0,0 @@
-export { default as Avatar } from "./Avatar";
-export { default as UserView } from "./UserView";
-export { default as GroupView } from "./GroupView";
-export { default as LoginBtn } from "./LoginBtn";

package/src/ui/navigation.ts

@@ -1,32 +0,0 @@
-/**
- * Browser-side navigation helpers — shared across every app's islands.
- *
- * Replaces the per-app `lib/navigation.ts` modules that all reimplemented the
- * same handful of `window.location` wrappers. Re-exported from the `cloud/ui`
- * barrel so consumers `import { navigateTo, refreshCurrentPath } from
- * "@valentinkolb/cloud/ui"`.
- */
-
-/**
- * Returns the canonical current URL path + query (without hash).
- * Used as a deterministic refresh target after mutations — `location.reload()`
- * preserves hash and forces a network revalidation we don't always want.
- */
-export const currentPathWithQuery = (): string => {
-  const url = new URL(window.location.href);
-  return `${url.pathname}${url.search}`;
-};
-
-/**
- * Navigates to the canonical current URL. Triggers full SSR re-render.
- */
-export const refreshCurrentPath = (): void => {
-  window.location.assign(currentPathWithQuery());
-};
-
-/**
- * Navigates to a target href via browser navigation (adds history entry).
- */
-export const navigateTo = (href: string): void => {
-  window.location.assign(href);
-};