@quazardous/qdadm 2.3.1 → 2.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quazardous/qdadm",
-  "version": "2.3.1",
+  "version": "2.4.1",
   "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
 // ─────────────────────────────────────────────────────────────────────────────

package/src/entity/EntityManager.query.ts

@@ -174,10 +174,12 @@ export function applyQueryMethods(EntityManagerClass: { prototype: any }): void
         const aVal = a[sort_by]
         const bVal = b[sort_by]
 
-        // Handle nulls
+        // Nulls always sort LAST, both directions (#1221) — matches the
+        // storage adapters' shared comparator; direction-aware placement
+        // put "never seen" rows on top of every desc date sort.
         if (aVal == null && bVal == null) return 0
-        if (aVal == null) return sort_order === 'asc' ? 1 : -1
-        if (bVal == null) return sort_order === 'asc' ? -1 : 1
+        if (aVal == null) return 1
+        if (bVal == null) return -1
 
         // Compare
         if (typeof aVal === 'string' && typeof bVal === 'string') {

package/src/generated/managers/testManager.ts

@@ -1,46 +0,0 @@
-/**
- * TestManager - Auto-generated EntityManager
- *
- * Generated by qdadm/gen/generateManagers
- * DO NOT EDIT MANUALLY - Changes will be overwritten
- *
- * Entity: test
- * Endpoint: /test
- */
-
-import { EntityManager } from '@quazardous/qdadm'
-import type { EntityRecord } from '@quazardous/qdadm'
-import { ApiStorage } from '@quazardous/qdadm'
-
-export interface TestEntity extends EntityRecord {
-}
-
-/**
- * Schema definition for test
- */
-export const testSchema = {
-  name: "test",
-  endpoint: "/test",
-  fields: {}
-} as const
-
-/**
- * Storage options for test
- */
-const storageOptions = {
-  endpoint: "/test"
-}
-
-/**
- * TestManager instance
- *
- * Provides CRUD operations for test entity.
- */
-export const testManager = new EntityManager<TestEntity>({
-  ...{
-  name: "test",
-  idField: "id",
-  fields: {}
-},
-  storage: new ApiStorage<TestEntity>(storageOptions)
-})