@htmlbricks/hb-paginate 0.62.33 → 0.64.0

package/manifest.json

@@ -96,6 +96,14 @@
                   "description": "Currently selected sort field",
                   "type": "string"
                 },
+                "sort_default_label": {
+                  "description": "Custom label for the \"Default\" sort option (e.g. \"Relevance\")",
+                  "type": "string"
+                },
+                "sort_default_value": {
+                  "description": "Value for the \"Default\" sort option (emitted as sort_by when default is selected)",
+                  "type": "string"
+                },
                 "sort_direction": {
                   "description": "Current sort direction",
                   "enum": [
@@ -132,10 +140,6 @@
                   "type": "number"
                 }
               },
-              "required": [
-                "total",
-                "size"
-              ],
               "type": "object"
             },
             "page": {
@@ -264,7 +268,7 @@
     },
     {
       "name": "withSort",
-      "description": "Pagination with sort indicator",
+      "description": "Pagination with sort indicator (active sort on title)",
       "data": {
         "page": 0,
         "pages": 4,
@@ -290,6 +294,92 @@
         }
       }
     },
+    {
+      "name": "withSortDefault",
+      "description": "Pagination with sort indicator showing Default (no active sort)",
+      "data": {
+        "page": 0,
+        "pages": 4,
+        "info": {
+          "total": 100,
+          "size": 25,
+          "sort_fields": [
+            {
+              "value": "title",
+              "label": "Title"
+            },
+            {
+              "value": "date",
+              "label": "Date"
+            },
+            {
+              "value": "status",
+              "label": "Status"
+            }
+          ],
+          "sort_by": "",
+          "sort_direction": "default"
+        }
+      }
+    },
+    {
+      "name": "withSortDefaultMatchingField",
+      "description": "Default sort matches a sortable field — 'Title' is pre-selected with default direction",
+      "data": {
+        "page": 0,
+        "pages": 4,
+        "info": {
+          "total": 100,
+          "size": 25,
+          "sort_fields": [
+            {
+              "value": "title",
+              "label": "Title"
+            },
+            {
+              "value": "date",
+              "label": "Date"
+            },
+            {
+              "value": "status",
+              "label": "Status"
+            }
+          ],
+          "sort_by": "title",
+          "sort_direction": "default",
+          "sort_default_value": "title"
+        }
+      }
+    },
+    {
+      "name": "withSortDefaultCustomLabel",
+      "description": "Custom label for the Default sort option (shows 'Relevance' instead of 'Default')",
+      "data": {
+        "page": 0,
+        "pages": 4,
+        "info": {
+          "total": 100,
+          "size": 25,
+          "sort_fields": [
+            {
+              "value": "title",
+              "label": "Title"
+            },
+            {
+              "value": "date",
+              "label": "Date"
+            },
+            {
+              "value": "status",
+              "label": "Status"
+            }
+          ],
+          "sort_by": "",
+          "sort_direction": "default",
+          "sort_default_label": "Relevance"
+        }
+      }
+    },
     {
       "name": "withSortAndPageSize",
       "description": "Pagination with sort and page size selector",
@@ -335,5 +425,5 @@
   "size": {},
   "iifePath": "main.iife.js",
   "repoName": "@htmlbricks/hb-paginate",
-  "version": "0.62.33"
+  "version": "0.64.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@htmlbricks/hb-paginate",
-  "version": "0.62.33",
+  "version": "0.64.0",
   "contributors": [],
   "description": "",
   "licenses": [

package/types/webcomponent.type.d.json

@@ -33,6 +33,14 @@
               "description": "Currently selected sort field",
               "type": "string"
             },
+            "sort_default_label": {
+              "description": "Custom label for the \"Default\" sort option (e.g. \"Relevance\")",
+              "type": "string"
+            },
+            "sort_default_value": {
+              "description": "Value for the \"Default\" sort option (emitted as sort_by when default is selected)",
+              "type": "string"
+            },
             "sort_direction": {
               "description": "Current sort direction",
               "enum": [
@@ -69,10 +77,6 @@
               "type": "number"
             }
           },
-          "required": [
-            "total",
-            "size"
-          ],
           "type": "object"
         },
         "page": {

package/types/webcomponent.type.d.ts

@@ -4,8 +4,8 @@ export type Component = {
   pages: number;
   page: number;
   info?: {
-    total: number;
-    size: number;
+    total?: number;
+    size?: number;
     /** Type of page size selector: "number" for free input, "select" for dropdown */
     page_size_type?: "number" | "select";
     /** Comma-separated list of page size options for select mode (e.g. "10,25,50,100") */
@@ -18,6 +18,10 @@ export type Component = {
     sort_direction?: "asc" | "desc" | "default";
     /** Whether the sort controls are disabled */
     sort_disabled?: boolean;
+    /** Value for the "Default" sort option (emitted as sort_by when default is selected) */
+    sort_default_value?: string;
+    /** Custom label for the "Default" sort option (e.g. "Relevance") */
+    sort_default_label?: string;
   };
   i18nlang?: string;
 };