@globalbrain/sefirot 4.53.0 → 4.54.0

package/lib/blocks/lens/components/LensCatalogStateSort.vue

@@ -39,9 +39,17 @@ const orderTextDict = {
 }
 
 function getFieldName(sort: LensQuerySort): string {
-  return lang === 'ja'
-    ? props.fields[sort[0]].labelJa
-    : props.fields[sort[0]].labelEn
+  // A still-applied sort can reference a field that's not in the field set — a
+  // stale saved/URL sort, or a sort emitted under a companion key (e.g. an
+  // avatar sorting by its display-name field). Fall back to the raw key rather
+  // than crash, mirroring how the filter chip handles an unknown field.
+  const field = props.fields[sort[0]]
+
+  if (!field) {
+    return sort[0]
+  }
+
+  return lang === 'ja' ? field.labelJa : field.labelEn
 }
 
 function getOrderText(sort: LensQuerySort): string {

package/lib/blocks/lens/fields/AvatarField.ts

@@ -29,6 +29,13 @@ export class AvatarField extends Field<AvatarFieldData> {
     return {}
   }
 
+  // Sort by the display-name companion (resolved by the active language), since
+  // the field value itself is the image URL. With no companion configured there's
+  // nothing meaningful to sort on, so the field stays unsortable (no sort menu).
+  protected override sortKey(): string | null {
+    return this.nameKey()
+  }
+
   override dataListItemComponent(): any {
     return this.defineDataListItemComponent((value) => {
       // Render nothing for a missing image so SDataListItem shows its empty

package/lib/blocks/lens/fields/Field.ts

@@ -81,12 +81,25 @@ export abstract class Field<T extends FieldData> {
     }
   }
 
+  /**
+   * The field key sorts are emitted under — the catalog sends it to the backend,
+   * which orders by that field's column. Defaults to the field's own key; a
+   * subtype whose own value isn't meaningful to sort on can redirect it (e.g. an
+   * avatar sorts by its display-name companion). A `null` makes the field
+   * unsortable, so no sort menu is shown.
+   */
+  protected sortKey(): string | null {
+    return this.data.key
+  }
+
   /**
    * Renders the table sort menu for the field. The sort maybe null when
-   * the field `sortable` option is false.
+   * the field `sortable` option is false (or it has no sortable key).
    */
   tableSortMenu(onSortUpdated: (sort: LensQuerySort) => void): DropdownSection | null {
-    if (!this.data.sortable) {
+    const sortKey = this.sortKey()
+
+    if (!this.data.sortable || sortKey === null) {
       return null
     }
 
@@ -100,8 +113,8 @@ export abstract class Field<T extends FieldData> {
     return {
       type: 'menu',
       options: [
-        { label: t.sort_asc, onClick: () => onSortUpdated?.([this.data.key, 'asc']) },
-        { label: t.sort_desc, onClick: () => onSortUpdated?.([this.data.key, 'desc']) }
+        { label: t.sort_asc, onClick: () => onSortUpdated?.([sortKey, 'asc']) },
+        { label: t.sort_desc, onClick: () => onSortUpdated?.([sortKey, 'desc']) }
       ]
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@globalbrain/sefirot",
-  "version": "4.53.0",
+  "version": "4.54.0",
   "description": "Vue Components for Global Brain Design System.",
   "keywords": [
     "components",