@byline/host-tanstack-start 3.20.2 → 3.20.3

package/dist/admin-shell/chrome/th-sortable.d.ts

@@ -15,8 +15,18 @@ export interface TableHeadingCellSortableProps extends TableHeadingCellProps {
     desc?: boolean;
     align?: 'left' | 'center' | 'right';
     className?: string;
+    /**
+     * The *effective* sort column/direction — URL params when present, else
+     * the collection's configured `defaultSort` (surfaced via the list
+     * response's `meta.order`/`meta.desc`). When provided, these drive the
+     * sort indicator instead of reading the URL directly, so a params-less
+     * landing still shows which column ordered the rows. Omit for the legacy
+     * URL-only behaviour.
+     */
+    activeOrder?: string;
+    activeDesc?: boolean;
 }
-export declare function TableHeadingCellSortable({ path: _path, fieldName, label, sortable, align, className, ...rest }: TableHeadingCellSortableProps & {
+export declare function TableHeadingCellSortable({ path: _path, fieldName, label, sortable, align, className, activeOrder, activeDesc, ...rest }: TableHeadingCellSortableProps & {
     ref?: React.RefObject<HTMLTableCellElement>;
 }): React.JSX.Element;
 export {};

package/dist/admin-shell/chrome/th-sortable.js

@@ -6,7 +6,7 @@ import classnames from "classnames";
 import { useNavigate } from "./loose-router.js";
 import { SortAscendingIcon, SortDescendingIcon, SortNeutralIcon } from "./sort-icons.js";
 import th_sortable_module from "./th-sortable.module.js";
-function TableHeadingCellSortable({ path: _path = '/', fieldName, label, sortable = false, align = 'left', className, ...rest }) {
+function TableHeadingCellSortable({ path: _path = '/', fieldName, label, sortable = false, align = 'left', className, activeOrder, activeDesc, ...rest }) {
     const navigate = useNavigate();
     const location = useRouterState({
         select: (s)=>s.location
@@ -27,13 +27,15 @@ function TableHeadingCellSortable({ path: _path = '/', fieldName, label, sortabl
         };
     useEffect(()=>{
         if (null != fieldName) {
-            const order = location.search.order;
-            const d = location.search.desc;
+            const order = void 0 !== activeOrder ? activeOrder : location.search.order;
+            const d = void 0 !== activeOrder ? activeDesc : location.search.desc;
             order === fieldName ? setDesc(d ?? false) : setDesc(null);
         }
     }, [
         fieldName,
-        location.search
+        location.search,
+        activeOrder,
+        activeDesc
     ]);
     const alignClasses = classnames({
         'byline-th-align-left': 'left' === align,

package/dist/admin-shell/collections/list.js

@@ -89,6 +89,8 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
     const searchParams = location.search;
     const isCanonicalView = !searchParams.order && !searchParams.desc && !searchParams.query && !searchParams.status;
     const dragEnabled = orderable && isCanonicalView && !!onReorder;
+    const activeOrder = searchParams.order ?? data?.meta.order;
+    const activeDesc = null != searchParams.order ? searchParams.desc : data?.meta.desc;
     const sensors = useSensors(useSensor(PointerSensor, {
         activationConstraint: {
             distance: 5
@@ -306,7 +308,9 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
                                                             sortable: column.sortable,
                                                             scope: "col",
                                                             align: column.align,
-                                                            className: column.className
+                                                            className: column.className,
+                                                            activeOrder: activeOrder,
+                                                            activeDesc: activeDesc
                                                         }, String(column.fieldName)))
                                                 ]
                                             })
@@ -351,7 +355,9 @@ const ListView = ({ data, columns, workflowStatuses, useAsTitle, orderable = fal
                                                 sortable: column.sortable,
                                                 scope: "col",
                                                 align: column.align,
-                                                className: column.className
+                                                className: column.className,
+                                                activeOrder: activeOrder,
+                                                activeDesc: activeDesc
                                             }, String(column.fieldName)))
                                     })
                                 }),

package/dist/server-fns/collections/list.js

@@ -20,8 +20,15 @@ const getCollectionDocuments = createServerFn({
     const where = {};
     if (params.status) where.status = params.status;
     if (params.query) where.query = params.query;
+    const adminConfig = getCollectionAdminConfig(path);
+    const configuredSort = params.order || true === config.definition.orderable || adminConfig?.defaultSort == null ? void 0 : {
+        order: String(adminConfig.defaultSort.field),
+        desc: 'desc' === adminConfig.defaultSort.direction
+    };
     const defaultSort = true === config.definition.orderable ? {
         order_key: 'asc'
+    } : null != configuredSort ? {
+        [configuredSort.order]: configuredSort.desc ? 'desc' : 'asc'
     } : void 0;
     const sortSpec = params.order ? {
         [params.order]: false === params.desc ? 'asc' : 'desc'
@@ -57,8 +64,8 @@ const getCollectionDocuments = createServerFn({
         docs,
         meta: {
             ...result.meta,
-            order: params.order,
-            desc: params.desc
+            order: params.order ?? configuredSort?.order,
+            desc: params.desc ?? configuredSort?.desc
         },
         included: {
             collection: {

package/package.json

@@ -3,7 +3,7 @@
   "private": false,
   "type": "module",
   "license": "MPL-2.0",
-  "version": "3.20.2",
+  "version": "3.20.3",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -119,13 +119,13 @@
     "react-swipeable": "^7.0.2",
     "uuid": "^14.0.1",
     "zod": "^4.4.3",
-    "@byline/client": "3.20.2",
-    "@byline/auth": "3.20.2",
-    "@byline/i18n": "3.20.2",
-    "@byline/ai": "3.20.2",
-    "@byline/admin": "3.20.2",
-    "@byline/core": "3.20.2",
-    "@byline/ui": "3.20.2"
+    "@byline/admin": "3.20.3",
+    "@byline/i18n": "3.20.3",
+    "@byline/ai": "3.20.3",
+    "@byline/ui": "3.20.3",
+    "@byline/client": "3.20.3",
+    "@byline/core": "3.20.3",
+    "@byline/auth": "3.20.3"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.167.0",

package/src/admin-shell/chrome/th-sortable.tsx

@@ -27,6 +27,16 @@ export interface TableHeadingCellSortableProps extends TableHeadingCellProps {
   desc?: boolean
   align?: 'left' | 'center' | 'right'
   className?: string
+  /**
+   * The *effective* sort column/direction — URL params when present, else
+   * the collection's configured `defaultSort` (surfaced via the list
+   * response's `meta.order`/`meta.desc`). When provided, these drive the
+   * sort indicator instead of reading the URL directly, so a params-less
+   * landing still shows which column ordered the rows. Omit for the legacy
+   * URL-only behaviour.
+   */
+  activeOrder?: string
+  activeDesc?: boolean
 }
 
 export function TableHeadingCellSortable({
@@ -36,6 +46,8 @@ export function TableHeadingCellSortable({
   sortable = false,
   align = 'left',
   className,
+  activeOrder,
+  activeDesc,
   ...rest
 }: TableHeadingCellSortableProps & {
   ref?: React.RefObject<HTMLTableCellElement>
@@ -61,15 +73,21 @@ export function TableHeadingCellSortable({
 
   useEffect(() => {
     if (fieldName != null) {
-      const order = (location.search as Record<string, unknown>).order
-      const d = (location.search as Record<string, unknown>).desc as boolean | undefined
+      // Prefer the effective sort passed down by the list view (which folds
+      // in a configured `defaultSort`); fall back to reading the URL.
+      const order =
+        activeOrder !== undefined ? activeOrder : (location.search as Record<string, unknown>).order
+      const d =
+        activeOrder !== undefined
+          ? activeDesc
+          : ((location.search as Record<string, unknown>).desc as boolean | undefined)
       if (order === fieldName) {
         setDesc(d ?? false)
       } else {
         setDesc(null)
       }
     }
-  }, [fieldName, location.search])
+  }, [fieldName, location.search, activeOrder, activeDesc])
 
   const alignClasses = cx({
     'byline-th-align-left': align === 'left',

package/src/admin-shell/collections/list.tsx

@@ -207,6 +207,14 @@ export const ListView = ({
     !searchParams.order && !searchParams.desc && !searchParams.query && !searchParams.status
   const dragEnabled = orderable && isCanonicalView && !!onReorder
 
+  // The *effective* sort for the header indicators: explicit URL params win;
+  // otherwise the server echoes a configured `defaultSort` (admin config)
+  // through `meta.order`/`meta.desc`, so a params-less landing still shows
+  // which column ordered the rows. (Orderable collections never set
+  // `meta.order` — their default is the drag order, indicated separately.)
+  const activeOrder = searchParams.order ?? data?.meta.order
+  const activeDesc = searchParams.order != null ? searchParams.desc : data?.meta.desc
+
   const sensors = useSensors(
     useSensor(PointerSensor, { activationConstraint: { distance: 5 } }),
     useSensor(KeyboardSensor, { coordinateGetter: sortableKeyboardCoordinates })
@@ -418,6 +426,8 @@ export const ListView = ({
                             scope="col"
                             align={column.align}
                             className={column.className}
+                            activeOrder={activeOrder}
+                            activeDesc={activeDesc}
                           />
                         )
                       })}
@@ -496,6 +506,8 @@ export const ListView = ({
                         scope="col"
                         align={column.align}
                         className={column.className}
+                        activeOrder={activeOrder}
+                        activeDesc={activeDesc}
                       />
                     )
                   })}

package/src/server-fns/collections/list.ts

@@ -69,11 +69,27 @@ export const getCollectionDocuments = createServerFn({ method: 'GET' })
     if (params.status) where.status = params.status
     if (params.query) where.query = params.query
 
-    // Default sort for `orderable: true` collections is the fractional
-    // `order_key` ascending. Caller's explicit `params.order` always wins
-    // so the admin can re-sort by other columns without surprise.
+    // Sort precedence: the caller's explicit `params.order` always wins (a
+    // shared link opens exactly as sent) → `orderable: true` collections
+    // default to the fractional `order_key` ascending → the admin config's
+    // `defaultSort` (boot-validated; mutually exclusive with `orderable`) →
+    // the storage fallback (`created_at desc`). `configuredSort` is also
+    // echoed through `meta.order`/`meta.desc` below so the list header can
+    // render the effective sort indicator on a params-less landing.
+    const adminConfig = getCollectionAdminConfig(path)
+    const configuredSort =
+      !params.order && config.definition.orderable !== true && adminConfig?.defaultSort != null
+        ? {
+            order: String(adminConfig.defaultSort.field),
+            desc: adminConfig.defaultSort.direction === 'desc',
+          }
+        : undefined
     const defaultSort: Record<string, 'asc' | 'desc'> | undefined =
-      config.definition.orderable === true ? { order_key: 'asc' } : undefined
+      config.definition.orderable === true
+        ? { order_key: 'asc' }
+        : configuredSort != null
+          ? { [configuredSort.order]: configuredSort.desc ? 'desc' : 'asc' }
+          : undefined
     const sortSpec: Record<string, 'asc' | 'desc'> | undefined = params.order
       ? { [params.order]: params.desc === false ? 'asc' : 'desc' }
       : defaultSort
@@ -131,8 +147,12 @@ export const getCollectionDocuments = createServerFn({ method: 'GET' })
       docs,
       meta: {
         ...result.meta,
-        order: params.order,
-        desc: params.desc,
+        // The *effective* sort: explicit params, or the configured
+        // `defaultSort` when it filled in. The list header renders its
+        // sort indicator from this, so a params-less landing still shows
+        // which column ordered the rows.
+        order: params.order ?? configuredSort?.order,
+        desc: params.desc ?? configuredSort?.desc,
       },
       included: {
         collection: {