@masterteam/work-center 0.0.62 → 0.0.63

package/fesm2022/masterteam-work-center.mjs

@@ -220,6 +220,13 @@ const WORK_CENTER_LEVEL_NAME_KEY = 'levelDataName';
 const WORK_CENTER_LEVEL_GROUP_FIELD = '__mtLevelGroup';
 /** Rendered in place of a missing / restricted LevelData label. */
 const WORK_CENTER_EMPTY_LABEL = '—';
+/**
+ * Bootstrap `group` value meaning "the user turned grouping off". Needed
+ * because an absent `group` means "not chosen yet" and falls back to the
+ * default grouping — without a distinct value, clearing the group would be
+ * undone by the next navigation.
+ */
+const WORK_CENTER_GROUP_NONE = 'none';
 
 const AREA_COLORS = ['violet', 'blue', 'emerald', 'amber', 'teal'];
 /** Fallback accent rotation used only when the backend sends no stat color. */
@@ -306,15 +313,23 @@ function parseSortInput(value) {
         : [];
 }
 /**
- * Resolves the grouped column key from bootstrap inputs. Mirrors the `sort`
- * rules: a present value wins, an explicit `null` clears, `undefined` keeps
- * whatever is already in state.
+ * Resolves the grouped column key from bootstrap inputs.
+ *
+ * A missing `group` means "not chosen yet" and keeps whatever state already
+ * has — which starts at the area default, so a first visit lands grouped.
+ * `WORK_CENTER_GROUP_NONE` is the only way to express "the user turned it
+ * off"; a bare `null` can't, because it is also what a host passes for an
+ * absent query param.
  */
 function resolveGroupByFromInputs(current, group) {
-    if (hasParamValue(group)) {
-        return typeof group === 'string' ? group.trim() || null : null;
+    if (!hasParamValue(group) || typeof group !== 'string') {
+        return current;
+    }
+    const parsed = group.trim();
+    if (!parsed || parsed === WORK_CENTER_GROUP_NONE) {
+        return null;
     }
-    return group === null ? null : current;
+    return parsed;
 }
 function parseFiltersInput(value) {
     const parsed = parseJson(value);
@@ -447,7 +462,13 @@ function buildColumnsFromProperties(properties) {
  */
 function withLevelNameGrouping(key) {
     return key === WORK_CENTER_LEVEL_NAME_KEY
-        ? { groupable: true, groupKey: WORK_CENTER_LEVEL_GROUP_FIELD }
+        ? {
+            groupable: true,
+            groupKey: WORK_CENTER_LEVEL_GROUP_FIELD,
+            // A level name names itself — "Level Name · Project Gamma" would just
+            // repeat the column header down every group.
+            showGroupColumnLabel: false,
+        }
         : {};
 }
 function buildColumns(columnsConfig) {
@@ -543,6 +564,19 @@ function buildKpis(stats, fallbackIcon) {
         color: stat.color?.trim() || KPI_COLORS[index % KPI_COLORS.length],
     }));
 }
+/**
+ * Level Name grouping is the default view of the personal work areas — those
+ * rows come from all over the hierarchy, so "which project is this?" is the
+ * first question a user has. Workspace is already scoped to one record, so
+ * grouping it by that record would produce a single group.
+ */
+function defaultGroupBy(area) {
+    return area === 'Workspace' ? null : WORK_CENTER_LEVEL_NAME_KEY;
+}
+/** The backend sort that renders a grouped column as contiguous rows. */
+function sortForGroup(groupBy) {
+    return groupBy ? [{ field: groupBy, dir: 'asc' }] : [];
+}
 function createDefaultContext(area) {
     return {
         area,
@@ -551,7 +585,7 @@ function createDefaultContext(area) {
         selectedCardKey: null,
         page: 1,
         pageSize: WORK_CENTER_LOCAL_FETCH_SIZE,
-        sort: [],
+        sort: sortForGroup(defaultGroupBy(area)),
         runtimeFilters: [],
         includeStats: true,
     };
@@ -561,7 +595,7 @@ function createDefaultAreaState(area) {
         context: createDefaultContext(area),
         headerFilters: [],
         columnFilters: [],
-        groupBy: null,
+        groupBy: defaultGroupBy(area),
         menuItems: [],
         rows: [],
         columns: [],
@@ -611,7 +645,14 @@ function normalizeContext(context) {
         runtimeFilters: sanitizeFilters(context.runtimeFilters),
     };
 }
-function buildContextFromInputs(currentContext, area, inputs = {}) {
+function buildContextFromInputs(currentContext, area, inputs = {}, 
+/**
+ * Already-resolved grouped column. Grouping is executed as a backend sort,
+ * so when the host supplies no explicit `sort` the grouped column defines
+ * it — that is what makes the default grouping reach the very first request
+ * instead of costing a second round trip.
+ */
+groupBy = null) {
     const parsedCardKey = toSelectedCardKey(inputs.card);
     const parsedTemplateId = toOptionalInt(inputs.templateId);
     const parsedLevelDataId = toOptionalInt(inputs.levelDataId);
@@ -628,9 +669,11 @@ function buildContextFromInputs(currentContext, area, inputs = {}) {
         levelDataId: parsedLevelDataId ?? currentContext.levelDataId,
         sort: hasParamValue(inputs.sort)
             ? parseSortInput(inputs.sort)
-            : inputs.sort === null
-                ? []
-                : currentContext.sort,
+            : groupBy
+                ? sortForGroup(groupBy)
+                : inputs.sort === null
+                    ? []
+                    : currentContext.sort,
         runtimeFilters: hasParamValue(inputs.filters)
             ? parseFiltersInput(inputs.filters)
             : inputs.filters === null
@@ -664,8 +707,20 @@ function mapRuntimeResponse(current, response) {
     const columns = buildColumns(selectedCard?.columnsConfig ?? selectedCardFromList?.columnsConfig);
     const rows = toDisplayRows(selectedCard?.items ?? [], columns);
     const kpis = buildKpis(selectedCard?.stats ?? [], selectedMenuItem?.icon ?? null);
+    // A card that doesn't advertise the grouped column can't be grouped by it —
+    // drop it here rather than letting the table discover the stale column and
+    // bounce a second request. The sort goes with it when it was the one the
+    // grouping asked for.
+    const groupBy = current.groupBy && columns.some((column) => column.key === current.groupBy)
+        ? current.groupBy
+        : null;
+    const droppedGroup = !groupBy && current.groupBy;
+    const sort = droppedGroup && isSortForGroup(current.context.sort, current.groupBy)
+        ? []
+        : current.context.sort;
     return {
         ...current,
+        groupBy,
         menuItems,
         rows,
         columns,
@@ -679,11 +734,16 @@ function mapRuntimeResponse(current, response) {
         context: {
             ...current.context,
             selectedCardKey,
+            sort,
             page: selectedCard?.pagination.page ?? current.context.page,
             pageSize: selectedCard?.pagination.pageSize ?? current.context.pageSize,
         },
     };
 }
+/** True when `sort` is exactly the single rule a grouping would produce. */
+function isSortForGroup(sort, groupBy) {
+    return !!groupBy && sort.length === 1 && sort[0].field === groupBy;
+}
 
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -784,8 +844,10 @@ let WorkCenterState = class WorkCenterState {
     setParams(ctx, action) {
         const state = ctx.getState();
         const current = state.byArea[action.area];
-        const nextContext = buildContextFromInputs(current.context, action.area, action.inputs);
+        // Resolve grouping first: with no explicit `sort` input it is what defines
+        // the backend sort, so the default grouping reaches the first request.
         const nextGroupBy = resolveGroupByFromInputs(current.groupBy, action.inputs?.group);
+        const nextContext = buildContextFromInputs(current.context, action.area, action.inputs, nextGroupBy);
         const areaChanged = state.activeArea !== action.area;
         const contextChanged = !isSameContext(current.context, nextContext);
         const groupChanged = nextGroupBy !== current.groupBy;
@@ -3189,5 +3251,5 @@ const APP_STATES = [WorkCenterState];
  * Generated bundle index. Do not edit.
  */
 
-export { APP_STATES, ApplyColumnFilters, ApplyHeaderFilters, ClearAllFilters, EnterArea, HydrateFromContext, LoadRuntime, SetGroupBy, SetLookups, SetParams, WORK_CENTER_EMPTY_LABEL, WORK_CENTER_LEVEL_GROUP_FIELD, WORK_CENTER_LEVEL_NAME_KEY, WORK_CENTER_MAX_FILTERS, WORK_CENTER_MAX_PAGE_SIZE, WORK_CENTER_MAX_SORT, WORK_CENTER_QUERY_VERSION, WorkCenterActionKey, WorkCenterClientFormModal, WorkCenterFacade, WorkCenterItemModal, WorkCenterItemModalRoute, WorkCenterPage, WorkCenterState, decodeWorkCenterRouteContextKey, encodeWorkCenterRouteContextKey };
+export { APP_STATES, ApplyColumnFilters, ApplyHeaderFilters, ClearAllFilters, EnterArea, HydrateFromContext, LoadRuntime, SetGroupBy, SetLookups, SetParams, WORK_CENTER_EMPTY_LABEL, WORK_CENTER_GROUP_NONE, WORK_CENTER_LEVEL_GROUP_FIELD, WORK_CENTER_LEVEL_NAME_KEY, WORK_CENTER_MAX_FILTERS, WORK_CENTER_MAX_PAGE_SIZE, WORK_CENTER_MAX_SORT, WORK_CENTER_QUERY_VERSION, WorkCenterActionKey, WorkCenterClientFormModal, WorkCenterFacade, WorkCenterItemModal, WorkCenterItemModalRoute, WorkCenterPage, WorkCenterState, decodeWorkCenterRouteContextKey, encodeWorkCenterRouteContextKey };
 //# sourceMappingURL=masterteam-work-center.mjs.map