@aures5g/vue-component-library 3.67.0 → 3.69.0

package/dist/src/components/table/TableHeaderCell.vue.d.ts

@@ -6,6 +6,7 @@ type __VLS_Props = {
     isLast: boolean;
     name: string;
     header: string;
+    description?: string;
     isSortable?: boolean;
     hasHeaderFilter?: boolean;
     icon?: FontAwesomeIconProps['icon'];

package/dist/src/components/table/TableHeaderRowItem.vue.d.ts

@@ -11,6 +11,7 @@ type __VLS_Props = {
     sort?: SortDirections;
     hasHeaderFilter?: boolean;
     header: string;
+    description?: string;
     icon?: FontAwesomeIconProps['icon'];
     getColumnWidth: (field: string) => Record<string, string | number>;
 };

package/dist/src/components/table/sortCycle.d.ts

@@ -4,14 +4,49 @@ export type SortState = {
     direction: SortDirections;
 } | null;
 /**
- * Pure state machine for the header sort click cycle (Bug #76979).
+ * Local click-count state for the header sort cycle (Bug #76979 / #76979
+ * follow-up). Tracks ONLY "which field was clicked, how many times in a
+ * row" — never the resulting `direction`, and never anything read back from
+ * the externally-bound `sortModel`. This is deliberate: a view can have its
+ * own default sort (`useDefineSort`'s `defaultSort`), so `sortModel` can
+ * already read e.g. `{ field: 'make', direction: 'asc' }` before the user
+ * has ever clicked anything. An earlier version of this state machine
+ * derived the next step from that externally-visible `direction` alone
+ * (`current.direction === DESC ? ASC : off`) — for a column whose default
+ * sort direction happens to be ASC (not DESC), the very first click was
+ * indistinguishable from "already at the ASC step, 3rd click coming up" and
+ * immediately reset the sort back to that same default (`off` -> `resetSort()`
+ * -> the identical default), so clicking such a column appeared to do
+ * nothing on the 1st click and never flipped on the 2nd (confirmed live: PR
+ * 11389, build 79082 — every system view's own default-sorted column, e.g.
+ * `make` on `basicView`, failed both checks in `view-suite.ts`).
+ * Deriving purely from click COUNT (this file), independent of whatever
+ * `sortModel` happened to already contain, cannot exhibit that ambiguity.
+ */
+export declare const SORT_CLICK_STEP: {
+    readonly FIRST: 1;
+    readonly SECOND: 2;
+};
+type SortClickStep = (typeof SORT_CLICK_STEP)[keyof typeof SORT_CLICK_STEP];
+export type SortClickState = {
+    field: string;
+    step: SortClickStep;
+} | null;
+/**
+ * Pure click-count state machine for the header sort click cycle.
  *
- * Single-column sort: clicking a column other than the currently sorted one
- * always starts that column fresh at DESC and drops the previous column's
- * sort — the direction is never inherited from another field. Clicking the
- * SAME column cycles DESC -> ASC -> off (null); off -> DESC restarts it. The
- * caller (TableHeaderRow.vue) reads `current` from its own `sortModel` and
- * feeds the clicked field name; the parent's `sortModel` setter already
- * treats `null` as "reset to the view's default sort".
+ * Single-column sort: clicking a column other than the one currently being
+ * cycled always restarts the cycle on that column (FIRST) — the previous
+ * column's cycle is dropped entirely, regardless of what `sortModel`
+ * currently shows for it. Clicking the SAME column advances FIRST -> SECOND
+ * -> off (null); off -> FIRST restarts it.
+ */
+export declare function nextSortClickState(current: SortClickState, clickedField: string): SortClickState;
+/**
+ * Maps a click-count state to the `sortModel` value `TableHeaderRow.vue`
+ * should assign: FIRST -> DESC, SECOND -> ASC, off (null) -> null (the
+ * parent's `sortModel` setter already treats `null` as "reset to the view's
+ * default sort").
  */
-export declare function nextSortState(current: SortState, clickedField: string): SortState;
+export declare function sortClickStateToSortModel(state: SortClickState): SortState;
+export {};

package/dist/src/components/table/uiTable.types.d.ts

@@ -4,6 +4,7 @@ import type { ClassValue, Component } from 'vue';
 export type Field = {
     name: string;
     header: string;
+    description?: string;
     icon?: FontAwesomeIconProps['icon'];
     isSortable?: boolean;
     hasHeaderFilter?: boolean;