@quazardous/qdadm 2.3.1 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quazardous/qdadm",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "Vue 3 framework for admin dashboards with PrimeVue",
   "author": "quazardous",
   "license": "MIT",

package/src/composables/useListPage.ts

@@ -89,6 +89,8 @@ import {
   clearSessionFilters,
   getSavedPageSize,
   getSessionFilters,
+  getSessionSort,
+  setSessionSort,
   persistPageSize,
   setSessionFilters,
   snakeToTitle,
@@ -114,6 +116,7 @@ export function useListPage<T = unknown>(config: UseListPageOptions<T>): UseList
     pageSize: defaultPageSize = 10,
     loadOnMount = true,
     persistFilters = true,
+    persistSort = true,
     syncUrlParams = true,
     autoLoadFilters = true,
     onBeforeLoad = null,
@@ -242,9 +245,11 @@ export function useListPage<T = unknown>(config: UseListPageOptions<T>): UseList
   const totalRecords = ref(0)
   const rowsPerPageOptions = PAGE_SIZE_OPTIONS
 
-  // Sorting
-  const sortField = ref<string | null>(defaultSort)
-  const sortOrder = ref(defaultSortOrder)
+  // Sorting — restored from the per-entity session (#1218), defaultSort as
+  // fallback; same persistence discipline as filters/pageSize.
+  const savedSort = persistSort ? getSessionSort(filterSessionKey) : null
+  const sortField = ref<string | null>(savedSort ? savedSort.field : defaultSort)
+  const sortOrder = ref(savedSort ? savedSort.order : defaultSortOrder)
 
   // Search
   const searchQuery = ref(savedSearch)
@@ -1002,6 +1007,12 @@ export function useListPage<T = unknown>(config: UseListPageOptions<T>): UseList
   function onSort(event: { sortField: string; sortOrder: number }): void {
     sortField.value = event.sortField
     sortOrder.value = event.sortOrder as 1 | -1
+    if (persistSort) {
+      setSessionSort(filterSessionKey, {
+        field: sortField.value,
+        order: sortOrder.value as 1 | -1,
+      })
+    }
     loadItems()
   }
 

package/src/composables/useListPage.types.ts

@@ -222,6 +222,8 @@ export interface UseListPageOptions<T = unknown> {
   loadOnMount?: boolean
   /** Persist filters to sessionStorage (default: true) */
   persistFilters?: boolean
+  /** Persist the active sort per entity (session storage), restored on init (#1218). Default true. */
+  persistSort?: boolean
   /** Sync filters to URL query params (default: true) */
   syncUrlParams?: boolean
   /** Filter mode: 'auto' | 'manager' | 'local' */

package/src/composables/useListPage.utils.ts

@@ -90,6 +90,45 @@ export function clearSessionFilters(key: string): void {
   }
 }
 
+// ─────────────────────────────────────────────────────────────────────────────
+// Sort session storage (#1218) — same mechanism as filters, keyed by entity
+// ─────────────────────────────────────────────────────────────────────────────
+
+const SORT_SESSION_PREFIX = 'qdadm_sort_'
+
+export interface SessionSort {
+  field: string | null
+  order: 1 | -1
+}
+
+export function getSessionSort(key: string): SessionSort | null {
+  try {
+    const stored = sessionStorage.getItem(SORT_SESSION_PREFIX + key)
+    if (!stored) return null
+    const parsed = JSON.parse(stored) as SessionSort
+    if (parsed && (parsed.order === 1 || parsed.order === -1)) return parsed
+    return null
+  } catch {
+    return null
+  }
+}
+
+export function setSessionSort(key: string, sort: SessionSort): void {
+  try {
+    sessionStorage.setItem(SORT_SESSION_PREFIX + key, JSON.stringify(sort))
+  } catch {
+    // Ignore storage errors (quota exceeded, disabled by user, …).
+  }
+}
+
+export function clearSessionSort(key: string): void {
+  try {
+    sessionStorage.removeItem(SORT_SESSION_PREFIX + key)
+  } catch {
+    // Ignore storage errors.
+  }
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Smart filter discovery
 // ─────────────────────────────────────────────────────────────────────────────