@agg-build/ui 4.4.0 → 4.7.1

package/dist/index.js

@@ -5653,6 +5653,19 @@ var resolveCategoryIdsFromPath = (path, fallbackCategoryIds) => {
   if (deepest) return [deepest];
   return fallbackCategoryIds;
 };
+var validateSubcategoryPath = (requestedPath, rootCategoryId, childrenByParentId) => {
+  var _a;
+  if (!rootCategoryId) return [];
+  const validPath = [];
+  let parentId = rootCategoryId;
+  for (const categoryId of requestedPath) {
+    const category = (_a = childrenByParentId.get(parentId)) == null ? void 0 : _a.find((child) => child.id === categoryId);
+    if (!category) break;
+    validPath.push(category.id);
+    parentId = category.id;
+  }
+  return validPath;
+};
 var resolveTabVenus = (tab, visibleVenues) => {
   const applyAllowList = (venues) => {
     if (!venues) {
@@ -18460,6 +18473,13 @@ var import_react30 = require("react");
 // src/events/list/event-list.constants.ts
 var import_sdk16 = require("@agg-build/sdk");
 var DEFAULT_EVENTS_LIMIT = 50;
+var DEFAULT_EVENT_LIST_SORT = "volume24hr";
+var EVENT_LIST_SORT_VALUES = [
+  "volume24hr",
+  "topArbitrage",
+  "volume",
+  "endDate"
+];
 var getDefaultEventListTabs = (labels) => {
   return [
     {
@@ -18529,6 +18549,7 @@ var getDefaultEventListTabs = (labels) => {
 
 // src/events/list/event-list-tabs.tsx
 var import_jsx_runtime155 = require("react/jsx-runtime");
+var DEFAULT_HIDDEN_VENUES = new Set((0, import_sdk17.getEffectiveDisabledVenues)(void 0));
 var renderTabIcon = (tab, isActive) => {
   if (tab.iconName === "warning-filled") {
     return /* @__PURE__ */ (0, import_jsx_runtime155.jsx)(Icon, { name: "warning-filled", size: "small", color: "currentColor" });
@@ -18557,15 +18578,11 @@ var useEventListTabs = (tabs) => {
       const availabilityState = (0, import_hooks55.getVenueAvailabilityState)({
         venueId: tab.venueLogo,
         disabledVenues,
-        // A compile-time-inactive venue (novig today) is hidden by default and
-        // un-hidden per-environment by NOVIG_DATA_VISIBLE, so its
-        // disabled-ness is only known once `/app/config` resolves — treating
-        // it as hidden while that request is in flight stops its tab flashing
-        // in and out where the flag is unset. Active venues must NOT be
-        // withheld, or they pop in late. Keyed off the shared inactive-venue
-        // helper rather than a venue name, so launching or retiring one needs
-        // no change here.
-        isConfigLoading: isAppConfigLoading && (0, import_sdk17.isVenueInactive)(tab.venueLogo),
+        // A globally inactive or default-disabled venue is hidden until
+        // `/app/config` resolves. That prevents partner-opt-in venues such as
+        // Novig from flashing briefly for apps that still disable them, while
+        // ordinary active venues continue rendering immediately.
+        isConfigLoading: isAppConfigLoading && ((0, import_sdk17.isVenueInactive)(tab.venueLogo) || DEFAULT_HIDDEN_VENUES.has(tab.venueLogo)),
         isLocationBlocked
       });
       if (availabilityState === "hidden") return [];
@@ -18743,10 +18760,16 @@ var EventList = ({
   getMarketHref,
   getEventHref,
   initialVenueTab,
+  activeVenueTab: controlledActiveVenueTab,
+  onActiveVenueTabChange,
+  selectedSort: controlledSelectedSort,
+  onSelectedSortChange,
+  categoryPath: controlledCategoryPath,
+  onCategoryPathChange,
   initialLoadedPageCount,
   stateRef
 }) => {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c, _d, _e, _f;
   const labels = (0, import_hooks56.useLabels)();
   const { disabledVenues } = (0, import_hooks56.useAppConfig)();
   const {
@@ -18758,13 +18781,37 @@ var EventList = ({
     () => disabledVenues.length === 0 ? void 0 : (0, import_hooks56.getVisibleVenueIdsByConfig)(import_sdk18.VENUES, disabledVenues),
     [disabledVenues]
   );
-  const [activeTabValue, setActiveTabValue] = (0, import_react31.useState)(
+  const [internalActiveTabValue, setInternalActiveTabValue] = (0, import_react31.useState)(
     (_b = initialVenueTab != null ? initialVenueTab : (_a = resolvedTabs[0]) == null ? void 0 : _a.value) != null ? _b : "matched"
   );
-  const [selectedSort, setSelectedSort] = (0, import_react31.useState)("volume24hr");
+  const activeTabValue = controlledActiveVenueTab != null ? controlledActiveVenueTab : internalActiveTabValue;
+  const [internalSelectedSort, setInternalSelectedSort] = (0, import_react31.useState)(DEFAULT_EVENT_LIST_SORT);
+  const selectedSort = controlledSelectedSort != null ? controlledSelectedSort : internalSelectedSort;
   const [isSubcategoriesModalOpen, setIsSubcategoriesModalOpen] = (0, import_react31.useState)(false);
-  const [categoryPath, setCategoryPath] = (0, import_react31.useState)([]);
+  const [internalCategoryPath, setInternalCategoryPath] = (0, import_react31.useState)([]);
+  const categoryPath = controlledCategoryPath != null ? controlledCategoryPath : internalCategoryPath;
   const [collapsedCategoryIds, setCollapsedCategoryIds] = (0, import_react31.useState)(() => /* @__PURE__ */ new Set());
+  const handleActiveTabChange = (0, import_react31.useCallback)(
+    (value) => {
+      if (controlledActiveVenueTab == null) setInternalActiveTabValue(value);
+      onActiveVenueTabChange == null ? void 0 : onActiveVenueTabChange(value, { history: "push" });
+    },
+    [controlledActiveVenueTab, onActiveVenueTabChange]
+  );
+  const handleSelectedSortChange = (0, import_react31.useCallback)(
+    (value) => {
+      if (controlledSelectedSort == null) setInternalSelectedSort(value);
+      onSelectedSortChange == null ? void 0 : onSelectedSortChange(value, { history: "push" });
+    },
+    [controlledSelectedSort, onSelectedSortChange]
+  );
+  const handleCategoryPathChange = (0, import_react31.useCallback)(
+    (value, options) => {
+      if (controlledCategoryPath == null) setInternalCategoryPath(value);
+      onCategoryPathChange == null ? void 0 : onCategoryPathChange(value, options);
+    },
+    [controlledCategoryPath, onCategoryPathChange]
+  );
   const sortItems = (0, import_react31.useMemo)(() => {
     return [
       {
@@ -18797,9 +18844,9 @@ var EventList = ({
   const baseCategoryId = (_c = categoryIds == null ? void 0 : categoryIds[0]) != null ? _c : null;
   (0, import_react31.useEffect)(() => {
     if (!isDiscoveryFiltersEnabled) return;
-    setCategoryPath([]);
+    if (controlledCategoryPath == null) setInternalCategoryPath([]);
     setCollapsedCategoryIds(/* @__PURE__ */ new Set());
-  }, [baseCategoryId, isDiscoveryFiltersEnabled]);
+  }, [baseCategoryId, controlledCategoryPath, isDiscoveryFiltersEnabled]);
   const { categories: topLevelCategories } = (0, import_hooks56.useCategories)({
     queryKeyScope: "event-list-top-categories",
     enabled: isDiscoveryFiltersEnabled,
@@ -18811,12 +18858,13 @@ var EventList = ({
   const baseCategoryChildPrefetchIds = (0, import_react31.useMemo)(() => {
     return Array.from(
       /* @__PURE__ */ new Set([
+        ...baseCategoryId ? [baseCategoryId] : [],
         ...sortedTopLevelCategories.map((category) => category.id),
         ...categoryPath.map((category) => category.id)
       ])
     );
-  }, [categoryPath, sortedTopLevelCategories]);
-  const { childrenByParentId: baseChildrenByParentId } = (0, import_hooks56.useCategoryChildren)({
+  }, [baseCategoryId, categoryPath, sortedTopLevelCategories]);
+  const { childrenByParentId: baseChildrenByParentId, isLoading: isBaseCategoryChildrenLoading } = (0, import_hooks56.useCategoryChildren)({
     queryKeyScope: "event-list-category-children",
     enabled: isDiscoveryFiltersEnabled,
     parentIds: baseCategoryChildPrefetchIds,
@@ -18866,7 +18914,36 @@ var EventList = ({
       ...visibleGrandchildrenByParentId
     ]);
   }, [baseChildrenByParentId, visibleChildrenByParentId, visibleGrandchildrenByParentId]);
-  const shouldRenderSubcategoryFilters = isDiscoveryFiltersEnabled && baseCategoryId !== null && (((_e = (_d = childrenByParentId.get(baseCategoryId)) == null ? void 0 : _d.length) != null ? _e : 0) > 0 || categoryPath.length > 0);
+  const controlledCategoryPathKey = (_d = controlledCategoryPath == null ? void 0 : controlledCategoryPath.map((entry) => entry.id).join(",")) != null ? _d : "";
+  const controlledCategoryPathValidationKey = `${baseCategoryId != null ? baseCategoryId : ""}|${controlledCategoryPathKey}`;
+  const [validatedCategoryPathKey, setValidatedCategoryPathKey] = (0, import_react31.useState)(
+    () => controlledCategoryPath == null || controlledCategoryPath.length === 0 ? controlledCategoryPathValidationKey : ""
+  );
+  (0, import_react31.useEffect)(() => {
+    if (controlledCategoryPath == null || controlledCategoryPath.length === 0) {
+      setValidatedCategoryPathKey(controlledCategoryPathValidationKey);
+      return;
+    }
+    if (isBaseCategoryChildrenLoading) return;
+    const requestedIds = controlledCategoryPath.map((entry) => entry.id);
+    const validIds = validateSubcategoryPath(requestedIds, baseCategoryId, baseChildrenByParentId);
+    if (validIds.length !== requestedIds.length) {
+      handleCategoryPathChange(controlledCategoryPath.slice(0, validIds.length), {
+        history: "replace"
+      });
+      return;
+    }
+    setValidatedCategoryPathKey(controlledCategoryPathValidationKey);
+  }, [
+    baseCategoryId,
+    baseChildrenByParentId,
+    controlledCategoryPath,
+    controlledCategoryPathKey,
+    controlledCategoryPathValidationKey,
+    handleCategoryPathChange,
+    isBaseCategoryChildrenLoading
+  ]);
+  const shouldRenderSubcategoryFilters = isDiscoveryFiltersEnabled && baseCategoryId !== null && (((_f = (_e = childrenByParentId.get(baseCategoryId)) == null ? void 0 : _e.length) != null ? _f : 0) > 0 || categoryPath.length > 0);
   const baseCategoryEventCount = (0, import_react31.useMemo)(() => {
     var _a2, _b2;
     return (_b2 = (_a2 = sortedTopLevelCategories.find((c) => c.id === baseCategoryId)) == null ? void 0 : _a2.eventCount) != null ? _b2 : 0;
@@ -18924,7 +19001,8 @@ var EventList = ({
     // markets experience is enabled (the sports event-detail view loads the
     // folded companions via aggKey). Gated on the same flag as that view.
     grouped: showSportsMarkets,
-    initialPages: initialLoadedPageCount
+    initialPages: initialLoadedPageCount,
+    enabled: controlledCategoryPath == null || validatedCategoryPathKey === controlledCategoryPathValidationKey
   });
   (0, import_react31.useEffect)(() => {
     if (stateRef) {
@@ -18985,7 +19063,7 @@ var EventList = ({
     "grid grid-cols-[repeat(auto-fill,minmax(240px,1fr))] md:grid-cols-[repeat(auto-fill,minmax(360px,1fr))] gap-4"
   );
   const handleSelectAllCategories = () => {
-    setCategoryPath([]);
+    handleCategoryPathChange([], { history: "push" });
     setCollapsedCategoryIds(/* @__PURE__ */ new Set());
     onCategoryRootChange == null ? void 0 : onCategoryRootChange(baseCategoryId != null ? baseCategoryId : void 0);
     setIsSubcategoriesModalOpen(false);
@@ -18997,7 +19075,7 @@ var EventList = ({
     isExpanded,
     isSelected
   }) => {
-    setCategoryPath((prev) => [...prev.slice(0, depth), entry]);
+    handleCategoryPathChange([...categoryPath.slice(0, depth), entry], { history: "push" });
     setCollapsedCategoryIds((prev) => {
       const next = new Set(prev);
       if (hasKnownChildren && isExpanded && isSelected) {
@@ -19037,7 +19115,7 @@ var EventList = ({
                 ariaLabel: labels.eventList.tabsAria(title2),
                 className: "agg-event-list-tabs min-w-0 flex-1 max-w-[600px]!",
                 activeTab: activeTabValue,
-                onTabChange: setActiveTabValue,
+                onTabChange: handleActiveTabChange,
                 overflowBehavior: "scroll"
               }
             ),
@@ -19047,7 +19125,7 @@ var EventList = ({
                 ariaLabel: labels.eventList.sortByLabel,
                 className: "min-w-[200px] w-auto! shrink-0 min-h-10.5",
                 value: selectedSort,
-                onChange: setSelectedSort,
+                onChange: handleSelectedSortChange,
                 items: sortItems,
                 contentClassName: "py-2",
                 triggerClassName: "rounded-agg-lg!"
@@ -19064,7 +19142,7 @@ var EventList = ({
           ariaLabel: labels.eventList.tabsAria(title2),
           className: "agg-event-list-tabs min-w-0 flex-1",
           activeTab: activeTabValue,
-          onTabChange: setActiveTabValue,
+          onTabChange: handleActiveTabChange,
           overflowBehavior: "select"
         }
       ),
@@ -19074,7 +19152,7 @@ var EventList = ({
           ariaLabel: labels.eventList.sortByLabel,
           className: "min-w-0 flex-1 md:min-w-[144px]",
           value: selectedSort,
-          onChange: setSelectedSort,
+          onChange: handleSelectedSortChange,
           items: sortItems,
           contentClassName: "rounded-[12px] py-2 shadow-[0_8px_16px_rgba(0,0,0,0.1)]"
         }
@@ -20750,7 +20828,7 @@ var getSmartRouteTotalFees = (feeBreakdown) => {
   if (!feeBreakdown) return null;
   const feeParts = [feeBreakdown.venueFees, feeBreakdown.bridgeFees, feeBreakdown.executionGas];
   if (!feeParts.every(Number.isFinite)) return null;
-  return feeParts.reduce((total, fee) => total + fee, 0);
+  return feeParts.reduce((total, fee) => total + Math.round(fee * 100) / 100, 0);
 };
 var getPlaceOrderContainerClassName = () => {
   return PLACE_ORDER_CONTAINER_CLASS_NAME;
@@ -21012,7 +21090,7 @@ var buildLiveRouteCards = ({
     // balance condition, and `handleExecuteQuote` rejects an empty quoteId.
     sq.venue !== primaryWinnerVenue
   ).map((sq) => {
-    var _a2;
+    var _a2, _b2;
     const parsedVenue = parseVenue(sq.venue);
     const venue = parsedVenue.success ? parsedVenue.data : void 0;
     if (geoBlockedVenues.has(sq.venue)) {
@@ -21045,7 +21123,12 @@ var buildLiveRouteCards = ({
       estimatedProfit: sq.estimatedProfit,
       returnPct: sq.returnPct,
       // venueSoloQuotes stripped on solo card's quoteData (only the primary needs them)
-      venueSoloQuotes: void 0
+      venueSoloQuotes: void 0,
+      // This solo's OWN fee breakdown. Without it the spread above leaves the
+      // primary route's breakdown in place, so selecting a bridge-free venue
+      // still showed the primary's bridging charge. Falls back to the
+      // primary only when the router omitted one (non-"ok" solos).
+      feeBreakdown: (_b2 = sq.feeBreakdown) != null ? _b2 : quoteData.feeBreakdown
     }), sq.quoteId ? { status: "ok", error: void 0 } : null);
     return {
       id: `live-solo-${sq.venue}`,
@@ -29508,6 +29591,85 @@ var resolveInitialTabValue = (tabs, defaultActiveTab) => {
   return (_b = (_a = tabs[0]) == null ? void 0 : _a.value) != null ? _b : ALL_CATEGORIES_TAB_VALUE;
 };
 
+// src/pages/home/event-discovery-url-state.ts
+var import_zod2 = require("zod");
+var nonEmptyParamSchema = import_zod2.z.string().trim().min(1);
+var sortParamSchema = import_zod2.z.enum(EVENT_LIST_SORT_VALUES);
+var readScalarParam = (searchParams, name, schema) => {
+  const values = searchParams.getAll(name);
+  if (values.length === 0) return { invalid: false };
+  if (values.length !== 1) return { invalid: true };
+  const parsedValue = schema.safeParse(values[0]);
+  if (!parsedValue.success) return { invalid: true };
+  return { value: parsedValue.data, invalid: false };
+};
+var readEventDiscoveryUrlState = (searchParams) => {
+  const category = readScalarParam(searchParams, "category", nonEmptyParamSchema);
+  const venue = readScalarParam(searchParams, "venue", nonEmptyParamSchema);
+  const sort = readScalarParam(searchParams, "sort", sortParamSchema);
+  const subcategoryPath = [];
+  let hasInvalidSubcategory = false;
+  for (const value of searchParams.getAll("subcategory")) {
+    const parsedValue = nonEmptyParamSchema.safeParse(value);
+    if (!parsedValue.success) {
+      hasInvalidSubcategory = true;
+      break;
+    }
+    subcategoryPath.push(parsedValue.data);
+  }
+  return {
+    category: category.value,
+    subcategoryPath,
+    venue: venue.value,
+    sort: sort.value,
+    categoryIsInvalid: category.invalid,
+    shouldCanonicalize: category.invalid || venue.invalid || sort.invalid || hasInvalidSubcategory
+  };
+};
+var resolveEventDiscoveryUrlState = ({
+  parsedState,
+  categoryValues,
+  venueValues,
+  defaultCategory,
+  defaultVenue
+}) => {
+  var _a, _b, _c;
+  const categoryIsValid = parsedState.category == null || categoryValues.includes(parsedState.category);
+  const venueIsValid = parsedState.venue == null || venueValues.includes(parsedState.venue);
+  const category = categoryIsValid ? (_a = parsedState.category) != null ? _a : defaultCategory : defaultCategory;
+  const venue = venueIsValid ? (_b = parsedState.venue) != null ? _b : defaultVenue : defaultVenue;
+  const sort = (_c = parsedState.sort) != null ? _c : DEFAULT_EVENT_LIST_SORT;
+  return {
+    state: {
+      category,
+      subcategoryPath: categoryIsValid && !parsedState.categoryIsInvalid ? parsedState.subcategoryPath : [],
+      venue,
+      sort
+    },
+    shouldCanonicalize: parsedState.shouldCanonicalize || !categoryIsValid || !venueIsValid || parsedState.category === defaultCategory || parsedState.venue === defaultVenue || parsedState.sort === DEFAULT_EVENT_LIST_SORT
+  };
+};
+var buildEventDiscoveryUrl = ({
+  currentUrl,
+  state,
+  defaultCategory,
+  defaultVenue
+}) => {
+  const nextUrl = new URL(currentUrl.toString());
+  nextUrl.searchParams.delete("category");
+  nextUrl.searchParams.delete("subcategory");
+  nextUrl.searchParams.delete("venue");
+  nextUrl.searchParams.delete("sort");
+  if (state.category !== defaultCategory) nextUrl.searchParams.set("category", state.category);
+  for (const subcategory of state.subcategoryPath) {
+    nextUrl.searchParams.append("subcategory", subcategory);
+  }
+  if (state.venue !== defaultVenue) nextUrl.searchParams.set("venue", state.venue);
+  if (state.sort !== DEFAULT_EVENT_LIST_SORT) nextUrl.searchParams.set("sort", state.sort);
+  const search = nextUrl.searchParams.toString();
+  return `${nextUrl.pathname}${search ? `?${search}` : ""}${nextUrl.hash}`;
+};
+
 // src/pages/home/use-scroll-restoration.ts
 var import_react46 = require("react");
 function useScrollRestoration({
@@ -29787,7 +29949,7 @@ var HomePage = ({
   onError,
   stickyOrderPanel
 }) => {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e, _f, _g;
   const labels = (0, import_hooks74.useLabels)();
   const {
     search: {
@@ -29797,8 +29959,11 @@ var HomePage = ({
       onChange: onSearchChange,
       onSelect: onSelectEventInternal
     },
-    trading: { executionMode }
+    trading: { executionMode },
+    features: { enableEventDiscoveryUrlPersistence }
   } = (0, import_hooks74.useSdkUiConfig)();
+  const { isLoading: isAppConfigLoading } = (0, import_hooks74.useAppConfig)();
+  const primaryEventListTabs = useEventListTabs();
   const { capture, consume } = (0, import_hooks74.useEventListState)();
   const [snapshot] = (0, import_react48.useState)(() => consume());
   const eventListStateRef = (0, import_react48.useRef)(null);
@@ -29869,7 +30034,7 @@ var HomePage = ({
   }, [isShowingAllResults, normalizedSearchValue, selectedEvent]);
   const resolvedSelectedEvent = selectedEvent != null ? selectedEvent : stickySelectedEvent;
   const resolvedAllCategoryTabLabel = allCategoryTabLabel === DEFAULT_ALL_CATEGORY_TAB_LABEL ? labels.home.trending : allCategoryTabLabel;
-  const { categories } = (0, import_hooks74.useCategories)({
+  const { categories, isLoading: isCategoriesLoading } = (0, import_hooks74.useCategories)({
     limit: categoriesLimit,
     enabled: !hasCustomTabs
   });
@@ -29880,22 +30045,180 @@ var HomePage = ({
     if (hasCustomTabs && tabs) return tabs;
     return categoryTabs;
   }, [categoryTabs, hasCustomTabs, tabs]);
+  const availableCategoryValues = (0, import_react48.useMemo)(
+    () => resolvedTabs.filter((tab) => !tab.disabled).map((tab) => tab.value),
+    [resolvedTabs]
+  );
+  const resolvedDefaultCategory = resolveInitialTabValue(resolvedTabs, defaultActiveTab);
+  const defaultCategory = availableCategoryValues.includes(resolvedDefaultCategory) ? resolvedDefaultCategory : (_a = availableCategoryValues[0]) != null ? _a : resolvedDefaultCategory;
+  const availableVenueTabs = (0, import_react48.useMemo)(
+    () => primaryEventListTabs.filter((tab) => !tab.disabled && !tab.isComingSoon),
+    [primaryEventListTabs]
+  );
+  const availableVenueValues = (0, import_react48.useMemo)(
+    () => availableVenueTabs.map((tab) => tab.value),
+    [availableVenueTabs]
+  );
+  const defaultVenue = (_c = (_b = availableVenueTabs[0]) == null ? void 0 : _b.value) != null ? _c : "matched";
   const resolvedEventSectionItems = eventSectionItems && eventSectionItems.length > 0 ? eventSectionItems : getDefaultEventSectionItems(labels);
-  const [activeTabValue, setActiveTabValue] = (0, import_react48.useState)(() => {
-    if (snapshot == null ? void 0 : snapshot.categoryTab) {
-      return snapshot.categoryTab;
+  const [discoveryFilterState, setDiscoveryFilterState] = (0, import_react48.useState)(
+    () => {
+      var _a2, _b2;
+      return {
+        category: (_a2 = snapshot == null ? void 0 : snapshot.categoryTab) != null ? _a2 : defaultCategory,
+        venue: (_b2 = snapshot == null ? void 0 : snapshot.venueTab) != null ? _b2 : defaultVenue,
+        sort: DEFAULT_EVENT_LIST_SORT,
+        subcategoryPath: []
+      };
     }
-    return resolveInitialTabValue(resolvedTabs, defaultActiveTab);
-  });
+  );
+  const discoveryFilterStateRef = (0, import_react48.useRef)(discoveryFilterState);
+  discoveryFilterStateRef.current = discoveryFilterState;
+  const [isUrlStateReady, setIsUrlStateReady] = (0, import_react48.useState)(!enableEventDiscoveryUrlPersistence);
+  const hasInitializedUrlStateRef = (0, import_react48.useRef)(false);
+  const activeTabValue = discoveryFilterState.category;
+  const resolveCurrentUrlState = (0, import_react48.useCallback)(() => {
+    if (typeof window === "undefined") return null;
+    const parsedState = readEventDiscoveryUrlState(new URL(window.location.href).searchParams);
+    const resolvedState = resolveEventDiscoveryUrlState({
+      parsedState,
+      categoryValues: availableCategoryValues,
+      venueValues: availableVenueValues,
+      defaultCategory,
+      defaultVenue
+    });
+    return {
+      state: {
+        category: resolvedState.state.category,
+        venue: resolvedState.state.venue,
+        sort: resolvedState.state.sort,
+        subcategoryPath: resolvedState.state.subcategoryPath.map((id) => ({
+          id,
+          label: id,
+          eventCount: 0
+        }))
+      },
+      shouldCanonicalize: resolvedState.shouldCanonicalize
+    };
+  }, [availableCategoryValues, availableVenueValues, defaultCategory, defaultVenue]);
+  const writeFilterStateToHistory = (0, import_react48.useCallback)(
+    (state, historyMode) => {
+      if (!enableEventDiscoveryUrlPersistence || typeof window === "undefined") return;
+      const currentUrl = new URL(window.location.href);
+      const nextUrl = buildEventDiscoveryUrl({
+        currentUrl,
+        state: {
+          category: state.category,
+          venue: state.venue,
+          sort: state.sort,
+          subcategoryPath: state.subcategoryPath.map((entry) => entry.id)
+        },
+        defaultCategory,
+        defaultVenue
+      });
+      const currentRelativeUrl = `${currentUrl.pathname}${currentUrl.search}${currentUrl.hash}`;
+      if (nextUrl === currentRelativeUrl) return;
+      const method = historyMode === "push" ? "pushState" : "replaceState";
+      window.history[method](window.history.state, "", nextUrl);
+    },
+    [defaultCategory, defaultVenue, enableEventDiscoveryUrlPersistence]
+  );
+  const commitDiscoveryFilterState = (0, import_react48.useCallback)(
+    (state, historyMode) => {
+      discoveryFilterStateRef.current = state;
+      setDiscoveryFilterState(state);
+      if (isUrlStateReady) writeFilterStateToHistory(state, historyMode);
+    },
+    [isUrlStateReady, writeFilterStateToHistory]
+  );
+  (0, import_react48.useEffect)(() => {
+    if (!enableEventDiscoveryUrlPersistence) {
+      hasInitializedUrlStateRef.current = false;
+      setIsUrlStateReady(true);
+      return;
+    }
+    if (hasInitializedUrlStateRef.current) return;
+    if (!hasCustomTabs && isCategoriesLoading || isAppConfigLoading) return;
+    const resolvedUrlState = resolveCurrentUrlState();
+    if (!resolvedUrlState) return;
+    hasInitializedUrlStateRef.current = true;
+    discoveryFilterStateRef.current = resolvedUrlState.state;
+    setDiscoveryFilterState(resolvedUrlState.state);
+    setIsUrlStateReady(true);
+    const currentUrl = new URL(window.location.href);
+    const canonicalUrl = buildEventDiscoveryUrl({
+      currentUrl,
+      state: {
+        category: resolvedUrlState.state.category,
+        venue: resolvedUrlState.state.venue,
+        sort: resolvedUrlState.state.sort,
+        subcategoryPath: resolvedUrlState.state.subcategoryPath.map((entry) => entry.id)
+      },
+      defaultCategory,
+      defaultVenue
+    });
+    const currentRelativeUrl = `${currentUrl.pathname}${currentUrl.search}${currentUrl.hash}`;
+    if (resolvedUrlState.shouldCanonicalize || canonicalUrl !== currentRelativeUrl) {
+      window.history.replaceState(window.history.state, "", canonicalUrl);
+    }
+  }, [
+    defaultCategory,
+    defaultVenue,
+    enableEventDiscoveryUrlPersistence,
+    hasCustomTabs,
+    isAppConfigLoading,
+    isCategoriesLoading,
+    resolveCurrentUrlState
+  ]);
+  (0, import_react48.useEffect)(() => {
+    if (!enableEventDiscoveryUrlPersistence || !isUrlStateReady) return;
+    const handlePopState = () => {
+      const resolvedUrlState = resolveCurrentUrlState();
+      if (!resolvedUrlState) return;
+      discoveryFilterStateRef.current = resolvedUrlState.state;
+      setDiscoveryFilterState(resolvedUrlState.state);
+      if (resolvedUrlState.shouldCanonicalize) {
+        writeFilterStateToHistory(resolvedUrlState.state, "replace");
+      }
+    };
+    window.addEventListener("popstate", handlePopState);
+    return () => {
+      window.removeEventListener("popstate", handlePopState);
+    };
+  }, [
+    enableEventDiscoveryUrlPersistence,
+    isUrlStateReady,
+    resolveCurrentUrlState,
+    writeFilterStateToHistory
+  ]);
   const activeTabValueRef = (0, import_react48.useRef)(activeTabValue);
   activeTabValueRef.current = activeTabValue;
   (0, import_react48.useEffect)(() => {
-    setActiveTabValue((currentValue) => {
-      const hasCurrentValue = resolvedTabs.some((tab) => tab.value === currentValue);
-      if (hasCurrentValue) return currentValue;
-      return resolveInitialTabValue(resolvedTabs, defaultActiveTab);
+    if (enableEventDiscoveryUrlPersistence && !isUrlStateReady) return;
+    const currentState = discoveryFilterStateRef.current;
+    const categoryIsAvailable = availableCategoryValues.includes(currentState.category);
+    const venueIsAvailable = availableVenueValues.includes(currentState.venue);
+    if (categoryIsAvailable && (!enableEventDiscoveryUrlPersistence || venueIsAvailable)) return;
+    const nextState = __spreadProps(__spreadValues({}, currentState), {
+      category: categoryIsAvailable ? currentState.category : defaultCategory,
+      venue: venueIsAvailable ? currentState.venue : defaultVenue,
+      subcategoryPath: categoryIsAvailable ? currentState.subcategoryPath : []
     });
-  }, [defaultActiveTab, resolvedTabs]);
+    if (enableEventDiscoveryUrlPersistence) {
+      commitDiscoveryFilterState(nextState, "replace");
+      return;
+    }
+    discoveryFilterStateRef.current = nextState;
+    setDiscoveryFilterState(nextState);
+  }, [
+    availableCategoryValues,
+    availableVenueValues,
+    commitDiscoveryFilterState,
+    defaultCategory,
+    defaultVenue,
+    enableEventDiscoveryUrlPersistence,
+    isUrlStateReady
+  ]);
   const tabsItems = (0, import_react48.useMemo)(() => {
     return resolvedTabs.map((tab) => {
       const isActive = tab.value === activeTabValue;
@@ -29936,7 +30259,13 @@ var HomePage = ({
     ];
   }, [activeTab, activeTabValue, resolvedEventSectionItems]);
   const handleTabChange = (value) => {
-    setActiveTabValue(value);
+    commitDiscoveryFilterState(
+      __spreadProps(__spreadValues({}, discoveryFilterStateRef.current), {
+        category: value,
+        subcategoryPath: []
+      }),
+      "push"
+    );
     _onTabChange == null ? void 0 : _onTabChange(value);
   };
   const handleCategoryRootChange = (categoryId) => {
@@ -29958,10 +30287,10 @@ var HomePage = ({
     handleSelectEvent(event);
   };
   const shouldRenderMobileSearch = isMobileSearchViewport && !resolvedSelectedEvent;
-  const isScrollRestorationReady = !!snapshot && !isShowingAllResults && !resolvedSelectedEvent && ((_b = (_a = eventListStateRef.current) == null ? void 0 : _a.loadedPageCount) != null ? _b : 0) >= ((_c = snapshot.loadedPageCount) != null ? _c : 1);
+  const isScrollRestorationReady = !!snapshot && !isShowingAllResults && !resolvedSelectedEvent && ((_e = (_d = eventListStateRef.current) == null ? void 0 : _d.loadedPageCount) != null ? _e : 0) >= ((_f = snapshot.loadedPageCount) != null ? _f : 1);
   useScrollRestoration({
     enabled: !!snapshot && snapshot.scrollY > 0,
-    scrollY: (_d = snapshot == null ? void 0 : snapshot.scrollY) != null ? _d : 0,
+    scrollY: (_g = snapshot == null ? void 0 : snapshot.scrollY) != null ? _g : 0,
     isReady: isScrollRestorationReady
   });
   return /* @__PURE__ */ (0, import_jsx_runtime176.jsx)(AggErrorBoundary, { onError, children: /* @__PURE__ */ (0, import_jsx_runtime176.jsxs)("section", { className: cn("agg-home-page flex w-full flex-col", classNames == null ? void 0 : classNames.root), children: [
@@ -30043,7 +30372,13 @@ var HomePage = ({
                   "div",
                   {
                     className: "agg-home-section",
-                    children: /* @__PURE__ */ (0, import_jsx_runtime176.jsx)(
+                    children: sectionIndex === 0 && !isUrlStateReady ? /* @__PURE__ */ (0, import_jsx_runtime176.jsx)(
+                      Skeleton,
+                      {
+                        view: "event-list",
+                        ariaLabel: labels.eventList.loading(eventSectionItem.title)
+                      }
+                    ) : /* @__PURE__ */ (0, import_jsx_runtime176.jsx)(
                       EventList,
                       __spreadValues({
                         title: eventSectionItem.title,
@@ -30059,11 +30394,33 @@ var HomePage = ({
                           handleSelectEvent(event);
                         },
                         onMarketClick: onMarketClickProp
-                      }, sectionIndex === 0 ? {
+                      }, sectionIndex === 0 ? __spreadValues({
                         stateRef: eventListStateRef,
-                        initialVenueTab: (_d2 = snapshot == null ? void 0 : snapshot.venueTab) != null ? _d2 : void 0,
+                        initialVenueTab: enableEventDiscoveryUrlPersistence ? void 0 : (_d2 = snapshot == null ? void 0 : snapshot.venueTab) != null ? _d2 : void 0,
                         initialLoadedPageCount: snapshot == null ? void 0 : snapshot.loadedPageCount
-                      } : void 0)
+                      }, enableEventDiscoveryUrlPersistence ? {
+                        activeVenueTab: discoveryFilterState.venue,
+                        onActiveVenueTabChange: (venue) => {
+                          commitDiscoveryFilterState(
+                            __spreadProps(__spreadValues({}, discoveryFilterStateRef.current), { venue }),
+                            "push"
+                          );
+                        },
+                        selectedSort: discoveryFilterState.sort,
+                        onSelectedSortChange: (sort) => {
+                          commitDiscoveryFilterState(
+                            __spreadProps(__spreadValues({}, discoveryFilterStateRef.current), { sort }),
+                            "push"
+                          );
+                        },
+                        categoryPath: discoveryFilterState.subcategoryPath,
+                        onCategoryPathChange: (subcategoryPath, options) => {
+                          commitDiscoveryFilterState(
+                            __spreadProps(__spreadValues({}, discoveryFilterStateRef.current), { subcategoryPath }),
+                            options.history
+                          );
+                        }
+                      } : void 0) : void 0)
                     )
                   },
                   `${(_a2 = eventSectionItem.id) != null ? _a2 : eventSectionItem.title}-${sectionIndex}`
@@ -30423,7 +30780,7 @@ var import_hooks77 = require("@agg-build/hooks");
 var import_sdk27 = require("@agg-build/sdk");
 var Dialog8 = __toESM(require("@radix-ui/react-dialog"));
 var import_react49 = require("react");
-var import_zod2 = require("zod");
+var import_zod3 = require("zod");
 var import_jsx_runtime179 = require("react/jsx-runtime");
 var USDC_DECIMALS = 6;
 var EDITABLE_AMOUNT_PATTERN = /^\d*(?:\.\d{0,6})?$/;
@@ -30448,7 +30805,7 @@ var VENUE_LABELS = {
   [import_sdk27.Venue.hyperliquid]: "Hyperliquid",
   [import_sdk27.Venue.novig]: "Novig"
 };
-var amountSchema = import_zod2.z.string().min(1).regex(FINAL_AMOUNT_PATTERN);
+var amountSchema = import_zod3.z.string().min(1).regex(FINAL_AMOUNT_PATTERN);
 var decimalToRaw = (value, decimals = USDC_DECIMALS) => {
   const parsed = amountSchema.safeParse(value.trim());
   if (!parsed.success) return null;