@openedx/frontend-app-gradebook 2.0.0-alpha.0

package/dist/components/GradesView/data/apiHook.js

@@ -0,0 +1,191 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { useMemo } from 'react';
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { useParams } from 'react-router-dom';
+import lms from '../../../data/services/lms';
+import { sortAlphaAsc } from '../../../data/formatUtils';
+import { filtersSnapshot } from '../../../data/filtersSnapshot';
+import { useGradebookUi } from '../../../data/gradebookUiContext';
+import { useCourseIdWithGate } from '../../../data/apiHook';
+import { trackGradesDisplayed, trackGradeOverrideSucceeded, trackGradeOverrideFailed, trackUploadOverrideSucceeded, trackUploadOverrideFailed, } from '../../../data/services/segment/events';
+// Cross-feature invalidation: a successful CSV upload refreshes the bulk-operation
+// history owned by the BulkManagementHistoryView feature.
+import { bulkOperationHistoryQueryKeys } from '../../BulkManagementHistoryView/data/queryKeys';
+import { getGradeOverrideHistory, getGrades, getGradesPage } from './api';
+import { gradeOverrideHistoryQueryKeys, gradesQueryKeys } from './queryKeys';
+import { buildGradesFetchParams } from './utils';
+/**
+ * Builds the `getGrades` params from the live `filtersSnapshot`. Reads at fetch
+ * time (not from the query key) so imperative refetches pick up the latest
+ * filter values — the FiltersProvider keeps `filtersSnapshot` in sync.
+ */
+const buildGradebookDataParams = () => buildGradesFetchParams(filtersSnapshot);
+/**
+ * useGrades()
+ * Single-responsibility query for the main gradebook rows. Caller supplies
+ * `courseId`, the current pagination cursor (`gradesPageEndpoint` from
+ * `GradebookUi`, or `null` for the base/unpaged page), and decides when it may
+ * run via `enabled`. The base grades key is a prefix of the paged key, so
+ * invalidating `byCourse(courseId)` still refetches any page. The first
+ * (unpaged) page reads the current filter params at fetch time (so an
+ * imperative `invalidateQueries` on filter apply / search refetches with the
+ * latest values); a non-null cursor fetches that opaque prev/next URL —
+ * replacing the legacy `fetchPrevNextGrades` thunk.
+ */
+export const useGrades = (courseId, gradesPageEndpoint, { enabled = true } = {}) => useQuery({
+    queryKey: [...gradesQueryKeys.byCourse(courseId), gradesPageEndpoint !== null && gradesPageEndpoint !== void 0 ? gradesPageEndpoint : 'base'],
+    queryFn: () => __awaiter(void 0, void 0, void 0, function* () {
+        const data = gradesPageEndpoint
+            ? yield getGradesPage(gradesPageEndpoint)
+            : yield getGrades(buildGradebookDataParams());
+        // Mirrors the legacy `receivedGrades` redux-beacon trigger: one event per
+        // actual fetch, with the filters it ran under and the resulting cursors.
+        trackGradesDisplayed({
+            assignmentType: filtersSnapshot.assignmentType,
+            cohort: filtersSnapshot.cohort,
+            track: filtersSnapshot.track,
+            prev: data.previous,
+            next: data.next,
+        });
+        return data;
+    }),
+    enabled: !!courseId && enabled,
+});
+/**
+ * useGradesData()
+ * Shapes the `useGrades` query into the read-model the grades table / counts /
+ * pagination consume — the React Query equivalent of the Redux `grades` slice
+ * fields that `useGradebookData` used to mirror. Results are sorted by username
+ * (matching the legacy `fetching.received` handling).
+ */
+export const useGradesData = () => {
+    var _a, _b, _c, _d;
+    const { courseId, enabled } = useCourseIdWithGate();
+    const { gradesPageEndpoint } = useGradebookUi();
+    const query = useGrades(courseId, gradesPageEndpoint, { enabled });
+    const data = query.data;
+    const results = useMemo(() => { var _a; return [...((_a = data === null || data === void 0 ? void 0 : data.results) !== null && _a !== void 0 ? _a : [])].sort(sortAlphaAsc); }, [data]);
+    return {
+        results,
+        prevPage: (_a = data === null || data === void 0 ? void 0 : data.previous) !== null && _a !== void 0 ? _a : null,
+        nextPage: (_b = data === null || data === void 0 ? void 0 : data.next) !== null && _b !== void 0 ? _b : null,
+        totalUsersCount: (_c = data === null || data === void 0 ? void 0 : data.total_users_count) !== null && _c !== void 0 ? _c : 0,
+        filteredUsersCount: (_d = data === null || data === void 0 ? void 0 : data.filtered_users_count) !== null && _d !== void 0 ? _d : 0,
+        isFetching: query.isFetching,
+        isError: query.isError,
+        isSuccess: query.isSuccess,
+    };
+};
+/**
+ * useGradeOverrideHistory(subsectionId, userId)
+ * Grade-override history for a single learner/subsection, used by the edit modal.
+ * Enabled only once both identifiers are present (i.e. the modal has been opened
+ * for a specific cell). `retry: false` because a `success: false` business error
+ * is not worth retrying.
+ */
+export const useGradeOverrideHistory = (subsectionId, userId) => (useQuery({
+    queryKey: gradeOverrideHistoryQueryKeys.byCell(subsectionId !== null && subsectionId !== void 0 ? subsectionId : null, userId !== null && userId !== void 0 ? userId : null),
+    queryFn: () => getGradeOverrideHistory(subsectionId, userId),
+    enabled: !!subsectionId && userId !== undefined && userId !== null,
+    retry: false,
+}));
+/**
+ * useUpdateGrades()
+ * Grade-override save from the edit modal. The HTTP call runs through React Query;
+ * success emits the Segment `update.*` event, shows the success banner, resets to
+ * the first grades page, and invalidates the grades query (so the table reflects
+ * the override) and the edited cell's override history (so reopening the modal
+ * shows the new entry).
+ *
+ * The payload is captured as mutation variables when the trigger is called (same
+ * shape as the old `selectors.app.editUpdateData`): the caller closes the modal
+ * right after triggering the save, and a pending mutation picks up re-rendered
+ * options, so a closure over `modalState` would read the reset (empty) state.
+ *
+ * Returns a no-arg trigger to match the legacy `useUpdateGrades()` call site.
+ */
+export const useUpdateGrades = () => {
+    const queryClient = useQueryClient();
+    const { courseId = '' } = useParams();
+    const { setShowSuccess, setGradesPageEndpoint, modalState } = useGradebookUi();
+    const mutation = useMutation({
+        mutationFn: (updateData) => lms.api.updateGradebookData(updateData),
+        onSuccess: ({ data }, updateData) => {
+            trackGradeOverrideSucceeded(data);
+            setShowSuccess(true);
+            setGradesPageEndpoint(null);
+            queryClient.invalidateQueries({
+                queryKey: gradesQueryKeys.byCourse(courseId),
+            });
+            updateData.forEach(({ usage_id: usageId, user_id: userId }) => {
+                queryClient.invalidateQueries({
+                    queryKey: gradeOverrideHistoryQueryKeys.byCell(usageId, userId),
+                });
+            });
+        },
+        onError: (error) => {
+            trackGradeOverrideFailed(error);
+        },
+    });
+    return () => {
+        mutation.mutate([{
+                grade: {
+                    comment: modalState.reasonForChange,
+                    earned_graded_override: modalState.adjustedGradeValue,
+                },
+                usage_id: modalState.updateModuleId,
+                user_id: modalState.updateUserId,
+            }]);
+    };
+};
+/**
+ * useSubmitImportGradesButtonData()
+ * Bulk grade-override CSV upload. The upload runs through React Query and, on
+ * success, invalidates the bulk-operation-history query so the new upload shows up.
+ * CSV progress/results/toast are React UI state (GradebookUi context) and success/
+ * failure emit the Segment `uploadOverride.*` events.
+ *
+ * Returns `(formData) => Promise` whose promise always resolves (errors are handled
+ * inside `onError`), matching the legacy thunk so the caller's `.then(clearInput)`
+ * still runs on both success and failure.
+ */
+export const useSubmitImportGradesButtonData = () => {
+    const queryClient = useQueryClient();
+    const { courseId = '' } = useParams();
+    const { setShowImportSuccessToast, resetCsvUpload, markCsvUploadSuccess, setCsvUploadErrors, } = useGradebookUi();
+    const mutation = useMutation({
+        mutationFn: (formData) => lms.api.uploadGradeCsv(formData),
+        onMutate: () => {
+            resetCsvUpload();
+        },
+        onSuccess: () => {
+            markCsvUploadSuccess();
+            setShowImportSuccessToast(true);
+            trackUploadOverrideSucceeded();
+            queryClient.invalidateQueries({
+                queryKey: bulkOperationHistoryQueryKeys.byCourse(courseId),
+            });
+        },
+        onError: (error) => {
+            var _a, _b;
+            trackUploadOverrideFailed(error);
+            if ((error === null || error === void 0 ? void 0 : error.status) === 200 && ((_b = (_a = error === null || error === void 0 ? void 0 : error.data) === null || _a === void 0 ? void 0 : _a.error_messages) === null || _b === void 0 ? void 0 : _b.length)) {
+                const { error_messages: errorMessages } = error.data;
+                setCsvUploadErrors(errorMessages);
+            }
+            else {
+                setCsvUploadErrors(['Unknown error.']);
+            }
+        },
+    });
+    return (formData) => mutation.mutateAsync(formData).catch(() => { });
+};
+//# sourceMappingURL=apiHook.js.map

package/dist/components/GradesView/data/apiHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiHook.js","sourceRoot":"","sources":["../../../../src/components/GradesView/data/apiHook.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react';\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\nimport { useParams } from 'react-router-dom';\n\nimport lms from '@src/data/services/lms';\nimport { sortAlphaAsc } from '@src/data/formatUtils';\nimport { filtersSnapshot } from '@src/data/filtersSnapshot';\nimport { useGradebookUi } from '@src/data/gradebookUiContext';\nimport { useCourseIdWithGate } from '@src/data/apiHook';\nimport {\n  trackGradesDisplayed,\n  trackGradeOverrideSucceeded,\n  trackGradeOverrideFailed,\n  trackUploadOverrideSucceeded,\n  trackUploadOverrideFailed,\n} from '@src/data/services/segment/events';\n// Cross-feature invalidation: a successful CSV upload refreshes the bulk-operation\n// history owned by the BulkManagementHistoryView feature.\nimport { bulkOperationHistoryQueryKeys } from '@src/components/BulkManagementHistoryView/data/queryKeys';\n\nimport { getGradeOverrideHistory, getGrades, getGradesPage } from './api';\nimport { gradeOverrideHistoryQueryKeys, gradesQueryKeys } from './queryKeys';\nimport { buildGradesFetchParams } from './utils';\n\n/**\n * Builds the `getGrades` params from the live `filtersSnapshot`. Reads at fetch\n * time (not from the query key) so imperative refetches pick up the latest\n * filter values — the FiltersProvider keeps `filtersSnapshot` in sync.\n */\nconst buildGradebookDataParams = () => buildGradesFetchParams(filtersSnapshot);\n\n/**\n * useGrades()\n * Single-responsibility query for the main gradebook rows. Caller supplies\n * `courseId`, the current pagination cursor (`gradesPageEndpoint` from\n * `GradebookUi`, or `null` for the base/unpaged page), and decides when it may\n * run via `enabled`. The base grades key is a prefix of the paged key, so\n * invalidating `byCourse(courseId)` still refetches any page. The first\n * (unpaged) page reads the current filter params at fetch time (so an\n * imperative `invalidateQueries` on filter apply / search refetches with the\n * latest values); a non-null cursor fetches that opaque prev/next URL —\n * replacing the legacy `fetchPrevNextGrades` thunk.\n */\nexport const useGrades = (\n  courseId: string,\n  gradesPageEndpoint: string | null,\n  { enabled = true }: { enabled?: boolean } = {},\n) => useQuery({\n  queryKey: [...gradesQueryKeys.byCourse(courseId), gradesPageEndpoint ?? 'base'],\n  queryFn: async () => {\n    const data = gradesPageEndpoint\n      ? await getGradesPage(gradesPageEndpoint)\n      : await getGrades(buildGradebookDataParams());\n    // Mirrors the legacy `receivedGrades` redux-beacon trigger: one event per\n    // actual fetch, with the filters it ran under and the resulting cursors.\n    trackGradesDisplayed({\n      assignmentType: filtersSnapshot.assignmentType,\n      cohort: filtersSnapshot.cohort,\n      track: filtersSnapshot.track,\n      prev: data.previous,\n      next: data.next,\n    });\n    return data;\n  },\n  enabled: !!courseId && enabled,\n});\n\n/** One subsection cell within a learner's grade row. */\nexport interface SubsectionBreakdown {\n  label: string;\n  category?: string;\n  subsection_name?: string;\n  module_id?: string;\n  score_possible?: number;\n  score_earned?: number;\n  percent?: number;\n  attempted?: boolean;\n  [key: string]: unknown;\n}\n\n/** One learner's grade row from the gradebook response. */\nexport interface GradeEntry {\n  user_id?: number;\n  username?: string;\n  external_user_key?: string;\n  email?: string;\n  percent?: number;\n  section_breakdown: SubsectionBreakdown[];\n  [key: string]: unknown;\n}\n\n/** Shaped grades read-model derived from the `useGrades` query. */\nexport interface GradesData {\n  results: GradeEntry[];\n  prevPage: string | null;\n  nextPage: string | null;\n  totalUsersCount: number;\n  filteredUsersCount: number;\n  isFetching: boolean;\n  isError: boolean;\n  isSuccess: boolean;\n}\n\n/**\n * useGradesData()\n * Shapes the `useGrades` query into the read-model the grades table / counts /\n * pagination consume — the React Query equivalent of the Redux `grades` slice\n * fields that `useGradebookData` used to mirror. Results are sorted by username\n * (matching the legacy `fetching.received` handling).\n */\nexport const useGradesData = (): GradesData => {\n  const { courseId, enabled } = useCourseIdWithGate();\n  const { gradesPageEndpoint } = useGradebookUi();\n  const query = useGrades(courseId, gradesPageEndpoint, { enabled });\n  const data = query.data as {\n    results?: GradeEntry[];\n    previous?: string | null;\n    next?: string | null;\n    total_users_count?: number;\n    filtered_users_count?: number;\n  } | undefined;\n  const results = useMemo(\n    () => [...(data?.results ?? [])].sort(sortAlphaAsc),\n    [data],\n  );\n  return {\n    results,\n    prevPage: data?.previous ?? null,\n    nextPage: data?.next ?? null,\n    totalUsersCount: data?.total_users_count ?? 0,\n    filteredUsersCount: data?.filtered_users_count ?? 0,\n    isFetching: query.isFetching,\n    isError: query.isError,\n    isSuccess: query.isSuccess,\n  };\n};\n\n/**\n * useGradeOverrideHistory(subsectionId, userId)\n * Grade-override history for a single learner/subsection, used by the edit modal.\n * Enabled only once both identifiers are present (i.e. the modal has been opened\n * for a specific cell). `retry: false` because a `success: false` business error\n * is not worth retrying.\n */\nexport const useGradeOverrideHistory = (subsectionId?: string, userId?: string | number) => (\n  useQuery({\n    queryKey: gradeOverrideHistoryQueryKeys.byCell(subsectionId ?? null, userId ?? null),\n    queryFn: () => getGradeOverrideHistory(subsectionId as string, userId as string | number),\n    enabled: !!subsectionId && userId !== undefined && userId !== null,\n    retry: false,\n  })\n);\n\n/** Shape of the rejection thrown by `uploadGradeCsv` (an HTTP response, not an Error). */\ninterface CsvUploadError {\n  status?: number;\n  data?: { error_messages?: string[]; saved?: number; total?: number };\n}\n\n/** One grade-override entry sent to the gradebook bulk-update endpoint. */\ninterface GradeOverrideUpdate {\n  grade: {\n    comment: string;\n    earned_graded_override: string | number;\n  };\n  usage_id: string | null;\n  user_id: number | null;\n}\n\n/**\n * useUpdateGrades()\n * Grade-override save from the edit modal. The HTTP call runs through React Query;\n * success emits the Segment `update.*` event, shows the success banner, resets to\n * the first grades page, and invalidates the grades query (so the table reflects\n * the override) and the edited cell's override history (so reopening the modal\n * shows the new entry).\n *\n * The payload is captured as mutation variables when the trigger is called (same\n * shape as the old `selectors.app.editUpdateData`): the caller closes the modal\n * right after triggering the save, and a pending mutation picks up re-rendered\n * options, so a closure over `modalState` would read the reset (empty) state.\n *\n * Returns a no-arg trigger to match the legacy `useUpdateGrades()` call site.\n */\nexport const useUpdateGrades = () => {\n  const queryClient = useQueryClient();\n  const { courseId = '' } = useParams();\n  const { setShowSuccess, setGradesPageEndpoint, modalState } = useGradebookUi();\n  const mutation = useMutation({\n    mutationFn: (updateData: GradeOverrideUpdate[]) => lms.api.updateGradebookData(updateData),\n    onSuccess: ({ data }, updateData) => {\n      trackGradeOverrideSucceeded(data);\n      setShowSuccess(true);\n      setGradesPageEndpoint(null);\n      queryClient.invalidateQueries({\n        queryKey: gradesQueryKeys.byCourse(courseId),\n      });\n      updateData.forEach(({ usage_id: usageId, user_id: userId }) => {\n        queryClient.invalidateQueries({\n          queryKey: gradeOverrideHistoryQueryKeys.byCell(usageId, userId),\n        });\n      });\n    },\n    onError: (error) => {\n      trackGradeOverrideFailed(error);\n    },\n  });\n  return () => {\n    mutation.mutate([{\n      grade: {\n        comment: modalState.reasonForChange,\n        earned_graded_override: modalState.adjustedGradeValue,\n      },\n      usage_id: modalState.updateModuleId,\n      user_id: modalState.updateUserId,\n    }]);\n  };\n};\n\n/**\n * useSubmitImportGradesButtonData()\n * Bulk grade-override CSV upload. The upload runs through React Query and, on\n * success, invalidates the bulk-operation-history query so the new upload shows up.\n * CSV progress/results/toast are React UI state (GradebookUi context) and success/\n * failure emit the Segment `uploadOverride.*` events.\n *\n * Returns `(formData) => Promise` whose promise always resolves (errors are handled\n * inside `onError`), matching the legacy thunk so the caller's `.then(clearInput)`\n * still runs on both success and failure.\n */\nexport const useSubmitImportGradesButtonData = () => {\n  const queryClient = useQueryClient();\n  const { courseId = '' } = useParams();\n  const {\n    setShowImportSuccessToast,\n    resetCsvUpload,\n    markCsvUploadSuccess,\n    setCsvUploadErrors,\n  } = useGradebookUi();\n  const mutation = useMutation<unknown, CsvUploadError, FormData>({\n    mutationFn: (formData) => lms.api.uploadGradeCsv(formData),\n    onMutate: () => {\n      resetCsvUpload();\n    },\n    onSuccess: () => {\n      markCsvUploadSuccess();\n      setShowImportSuccessToast(true);\n      trackUploadOverrideSucceeded();\n      queryClient.invalidateQueries({\n        queryKey: bulkOperationHistoryQueryKeys.byCourse(courseId),\n      });\n    },\n    onError: (error) => {\n      trackUploadOverrideFailed(error);\n      if (error?.status === 200 && error?.data?.error_messages?.length) {\n        const { error_messages: errorMessages } = error.data;\n        setCsvUploadErrors(errorMessages);\n      } else {\n        setCsvUploadErrors(['Unknown error.']);\n      }\n    },\n  });\n  return (formData: FormData) => mutation.mutateAsync(formData).catch(() => {});\n};\n"]}

package/dist/components/GradesView/data/hooks.d.ts

@@ -0,0 +1,32 @@
+export function useGradesHeadings(): (string | undefined)[];
+export function useSelectableAssignmentLabels(): import("./utils").AssignmentSummary[];
+export function useSelectedAssignmentData(): import("./utils").AssignmentSummary | undefined;
+export function useSelectedAssignmentLabel(): string | undefined;
+export function useShouldShowSpinner(): boolean;
+export function useAllGrades(): import("./apiHook").GradeEntry[];
+export function useUserCounts(): {
+    filteredUsersCount: number;
+    totalUsersCount: number;
+};
+export function useGradeData(): {
+    nextPage: string | null;
+    prevPage: string | null;
+    totalUsersCount: number;
+    filteredUsersCount: number;
+    gradeFormat: string;
+};
+export function useGradeExportUrl(): any;
+export function useInterventionExportUrl(): any;
+export function useFilterBadgeConfig(filterName: any): any;
+export function useGradeOverrideData(): {
+    gradeOverrideHistoryResults: any[];
+    gradeOverrideCurrentEarnedGradedOverride: number | null;
+    gradeOriginalEarnedGraded: number | null;
+    gradeOriginalPossibleGraded: number | null;
+    gradeOverrideHistoryError: string;
+    hasOverrideErrors: boolean;
+};
+export function useEditModalPossibleGrade(): string | number | null;
+export function useRefetchGrades(): () => void;
+export function useFetchGradesIfAssignmentGradeFiltersSet(): () => void;
+export function useFetchPrevNextGrades(): (endpoint: any) => void;

package/dist/components/GradesView/data/hooks.js

@@ -0,0 +1,242 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { useMemo } from 'react';
+import { useIsMutating, useQueryClient } from '@tanstack/react-query';
+import { useParams } from 'react-router-dom';
+import lms from '../../../data/services/lms';
+import initialFilters, { filterConfig, filters as filterNames } from '../../../data/constants/filters';
+import { useFilters } from '../../../data/filtersContext';
+import { useGradebookUi } from '../../../data/gradebookUiContext';
+import { useCanViewGradebook } from '../../../data/apiHook';
+import { useSelectedCohortEntry, useSelectedTrackEntry, } from '../../GradebookFilters/data/hooks';
+import { useGradesData, useGradeOverrideHistory } from './apiHook';
+import { gradesQueryKeys } from './queryKeys';
+import { chooseRelevantAssignmentData, formatMaxAssignmentGrade, formatMaxCourseGrade, formatMinAssignmentGrade, formatMinCourseGrade, getAssignmentsFromResultsSubstate, headingMapper, isDefault, relevantAssignmentDataFromResults, } from './utils';
+// Stable empty reference so read hooks don't return a fresh array each render.
+const EMPTY_ARRAY = [];
+/**
+ * useGradesHeadings()
+ * The gradebook table headings for the current assignment-type / assignment
+ * filters, derived from the grades query's section breakdown.
+ */
+export const useGradesHeadings = () => {
+    const { results } = useGradesData();
+    const { assignmentType, assignment: assignmentId } = useFilters();
+    return useMemo(() => {
+        var _a;
+        const selectedAssignmentLabel = (_a = relevantAssignmentDataFromResults(results, assignmentId)) === null || _a === void 0 ? void 0 : _a.label;
+        const sectionBreakdown = getAssignmentsFromResultsSubstate(results);
+        return headingMapper(assignmentType || 'All', selectedAssignmentLabel || 'All')(sectionBreakdown);
+    }, [results, assignmentType, assignmentId]);
+};
+/**
+ * useSelectableAssignmentLabels()
+ * The assignment options for the assignment dropdown, derived from the grades
+ * results and filtered by the current assignment-type.
+ */
+export const useSelectableAssignmentLabels = () => {
+    const { results } = useGradesData();
+    const { assignmentType } = useFilters();
+    return useMemo(() => {
+        const all = getAssignmentsFromResultsSubstate(results)
+            .map(chooseRelevantAssignmentData);
+        return (assignmentType && assignmentType !== 'All')
+            ? all.filter((assignment) => assignment.type === assignmentType)
+            : all;
+    }, [results, assignmentType]);
+};
+/**
+ * useSelectedAssignmentData()
+ * The currently-selected assignment's data (label/type/id, from the grades
+ * results), or undefined when no assignment is selected.
+ */
+export const useSelectedAssignmentData = () => {
+    const { results } = useGradesData();
+    const { assignment: assignmentId } = useFilters();
+    return useMemo(() => relevantAssignmentDataFromResults(results, assignmentId), [results, assignmentId]);
+};
+/**
+ * useSelectedAssignmentLabel()
+ * The label of the currently-selected assignment (from the grades results).
+ */
+export const useSelectedAssignmentLabel = () => { var _a; return (_a = useSelectedAssignmentData()) === null || _a === void 0 ? void 0 : _a.label; };
+/**
+ * useShouldShowSpinner()
+ * The busy indicator: the roles gate combined with the grades query fetching or
+ * any in-flight mutation (grade override save / CSV upload).
+ */
+export const useShouldShowSpinner = () => {
+    const canViewGradebook = useCanViewGradebook();
+    const { isFetching } = useGradesData();
+    const mutatingCount = useIsMutating();
+    return canViewGradebook && (isFetching || mutatingCount > 0);
+};
+/**
+ * useAllGrades()
+ * The (sorted) grades rows for the table.
+ */
+export const useAllGrades = () => useGradesData().results;
+/**
+ * useUserCounts()
+ * Filtered/total user counts from the grades query.
+ */
+export const useUserCounts = () => {
+    const { filteredUsersCount, totalUsersCount } = useGradesData();
+    return { filteredUsersCount, totalUsersCount };
+};
+/**
+ * useGradeData()
+ * The pagination cursors + counts (from the grades query) plus the current
+ * `gradeFormat` (from the GradebookUi context).
+ */
+export const useGradeData = () => {
+    const { nextPage, prevPage, totalUsersCount, filteredUsersCount, } = useGradesData();
+    const { gradeFormat } = useGradebookUi();
+    return {
+        nextPage, prevPage, totalUsersCount, filteredUsersCount, gradeFormat,
+    };
+};
+// Export URL args, built from the FiltersProvider (applied grade limits + the
+// immediate filters) and the selected cohort name. Reuses the pure
+// `format*` helpers so the CSV/intervention URL formatting is unchanged.
+const useLmsApiServiceArgs = () => {
+    const { assignment, assignmentType, track, includeCourseRoleMembers, appliedAssignmentGradeMin, appliedAssignmentGradeMax, appliedCourseGradeMin, appliedCourseGradeMax, } = useFilters();
+    const selectedCohort = useSelectedCohortEntry();
+    const assignmentId = assignment || undefined;
+    const opts = { assignmentId };
+    return {
+        cohort: selectedCohort ? selectedCohort.name : undefined,
+        track,
+        assignment: assignmentId,
+        assignmentType,
+        assignmentGradeMin: formatMinAssignmentGrade(appliedAssignmentGradeMin, opts),
+        assignmentGradeMax: formatMaxAssignmentGrade(appliedAssignmentGradeMax, opts),
+        courseGradeMin: formatMinCourseGrade(appliedCourseGradeMin),
+        courseGradeMax: formatMaxCourseGrade(appliedCourseGradeMax),
+        excludedCourseRoles: includeCourseRoleMembers ? '' : 'all',
+    };
+};
+export const useGradeExportUrl = () => lms.urls.gradeCsvUrl(useLmsApiServiceArgs());
+export const useInterventionExportUrl = () => lms.urls.interventionExportCsvUrl(useLmsApiServiceArgs());
+/**
+ * useFilterBadgeConfig(filterName)
+ * The badge config (value + isDefault) for a given filter, built from the
+ * FiltersProvider (immediate filters + applied grade limits + query-derived
+ * assignment label) and the selected cohort/track names. Reuses `filterConfig` +
+ * the pure `selectors.filters.isDefault` so formatting is unchanged.
+ */
+export const useFilterBadgeConfig = (filterName) => {
+    const selectedCohort = useSelectedCohortEntry();
+    const selectedTrack = useSelectedTrackEntry();
+    const selectedAssignmentLabel = useSelectedAssignmentLabel();
+    const { assignmentType, includeCourseRoleMembers, appliedAssignmentGradeMin, appliedAssignmentGradeMax, appliedCourseGradeMin, appliedCourseGradeMax, } = useFilters();
+    if (filterName === filterNames.cohort || filterName === filterNames.track) {
+        const entry = filterName === filterNames.cohort ? selectedCohort : selectedTrack;
+        const value = entry ? entry.name : '';
+        return Object.assign(Object.assign({}, filterConfig[filterName]), { value, isDefault: value === initialFilters[filterName] });
+    }
+    const _a = filterConfig[filterName], { filterOrder } = _a, config = __rest(_a, ["filterOrder"]);
+    if (filterOrder) {
+        const [min, max] = filterName === filterNames.assignmentGrade
+            ? [appliedAssignmentGradeMin, appliedAssignmentGradeMax]
+            : [appliedCourseGradeMin, appliedCourseGradeMax];
+        return Object.assign(Object.assign({}, config), { value: `${min} - ${max}`, isDefault: isDefault(filterOrder[0], min) && isDefault(filterOrder[1], max) });
+    }
+    const singleValues = {
+        [filterNames.assignmentType]: assignmentType,
+        [filterNames.assignment]: selectedAssignmentLabel || '',
+        [filterNames.includeCourseRoleMembers]: includeCourseRoleMembers,
+    };
+    const value = singleValues[filterName];
+    return Object.assign(Object.assign({}, config), { value, isDefault: isDefault(filterName, value) });
+};
+/**
+ * useGradeOverrideData()
+ * The edit-modal override read-model, sourced from the override-history query
+ * gated on the modal's subsection/user ids (from the GradebookUi context).
+ */
+export const useGradeOverrideData = () => {
+    var _a, _b, _c, _d, _e;
+    const { modalState } = useGradebookUi();
+    const query = useGradeOverrideHistory(modalState.updateModuleId, modalState.updateUserId);
+    const { data } = query;
+    return {
+        gradeOverrideHistoryResults: (_a = data === null || data === void 0 ? void 0 : data.overrideHistory) !== null && _a !== void 0 ? _a : EMPTY_ARRAY,
+        gradeOverrideCurrentEarnedGradedOverride: (_b = data === null || data === void 0 ? void 0 : data.currentEarnedGradedOverride) !== null && _b !== void 0 ? _b : null,
+        gradeOriginalEarnedGraded: (_c = data === null || data === void 0 ? void 0 : data.originalGradeEarnedGraded) !== null && _c !== void 0 ? _c : null,
+        gradeOriginalPossibleGraded: (_d = data === null || data === void 0 ? void 0 : data.originalGradePossibleGraded) !== null && _d !== void 0 ? _d : null,
+        gradeOverrideHistoryError: query.isError ? (((_e = query.error) === null || _e === void 0 ? void 0 : _e.message) || '') : '',
+        hasOverrideErrors: query.isError,
+    };
+};
+/**
+ * useEditModalPossibleGrade()
+ * The edit-modal "possible" grade: the context `adjustedGradePossible` or, as a
+ * fallback, the override query's original possible-graded value.
+ */
+export const useEditModalPossibleGrade = () => {
+    const { modalState } = useGradebookUi();
+    const { gradeOriginalPossibleGraded } = useGradeOverrideData();
+    return modalState.adjustedGradePossible || gradeOriginalPossibleGraded;
+};
+// Invalidate the main grades query, causing the mounted `useGrades` observer to
+// refetch with the current filters.
+const useInvalidateGrades = () => {
+    const queryClient = useQueryClient();
+    const { courseId = '' } = useParams();
+    return () => queryClient.invalidateQueries({ queryKey: gradesQueryKeys.byCourse(courseId) });
+};
+/**
+ * useRefetchGrades()
+ * Refetches the grades query from the first (unpaged) page with the latest
+ * filters. Always invalidates (the base-page cache entry may still be fresh, and
+ * a fresh entry is served as-is when the key flips back to it); when on a
+ * prev/next page, also clears the pagination cursor.
+ */
+export const useRefetchGrades = () => {
+    const invalidateGrades = useInvalidateGrades();
+    const { gradesPageEndpoint, setGradesPageEndpoint } = useGradebookUi();
+    return () => {
+        if (gradesPageEndpoint !== null) {
+            setGradesPageEndpoint(null);
+        }
+        invalidateGrades();
+    };
+};
+/**
+ * useFetchGradesIfAssignmentGradeFiltersSet()
+ * Refetches from the start only when a non-default applied assignment-grade limit
+ * is set (mirrors the legacy `areAssignmentGradeFiltersSet` gate).
+ */
+export const useFetchGradesIfAssignmentGradeFiltersSet = () => {
+    const refetchFromStart = useRefetchGrades();
+    const { appliedAssignmentGradeMin, appliedAssignmentGradeMax } = useFilters();
+    return () => {
+        const isSet = appliedAssignmentGradeMin !== initialFilters.assignmentGradeMin
+            || appliedAssignmentGradeMax !== initialFilters.assignmentGradeMax;
+        if (isSet) {
+            refetchFromStart();
+        }
+    };
+};
+/**
+ * useFetchPrevNextGrades()
+ * Pagination trigger: sets the page cursor in the GradebookUi context (the
+ * `useGrades` query keys off it and fetches that opaque prev/next URL).
+ */
+export const useFetchPrevNextGrades = () => {
+    const { setGradesPageEndpoint } = useGradebookUi();
+    return (endpoint) => {
+        setGradesPageEndpoint(endpoint);
+    };
+};
+//# sourceMappingURL=hooks.js.map

package/dist/components/GradesView/data/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../src/components/GradesView/data/hooks.js"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react';\nimport { useIsMutating, useQueryClient } from '@tanstack/react-query';\nimport { useParams } from 'react-router-dom';\n\nimport lms from '@src/data/services/lms';\nimport initialFilters, { filterConfig, filters as filterNames } from '@src/data/constants/filters';\nimport { useFilters } from '@src/data/filtersContext';\nimport { useGradebookUi } from '@src/data/gradebookUiContext';\nimport { useCanViewGradebook } from '@src/data/apiHook';\nimport {\n  useSelectedCohortEntry,\n  useSelectedTrackEntry,\n} from '@src/components/GradebookFilters/data/hooks';\n\nimport { useGradesData, useGradeOverrideHistory } from './apiHook';\nimport { gradesQueryKeys } from './queryKeys';\nimport {\n  chooseRelevantAssignmentData,\n  formatMaxAssignmentGrade,\n  formatMaxCourseGrade,\n  formatMinAssignmentGrade,\n  formatMinCourseGrade,\n  getAssignmentsFromResultsSubstate,\n  headingMapper,\n  isDefault,\n  relevantAssignmentDataFromResults,\n} from './utils';\n\n// Stable empty reference so read hooks don't return a fresh array each render.\nconst EMPTY_ARRAY = [];\n\n/**\n * useGradesHeadings()\n * The gradebook table headings for the current assignment-type / assignment\n * filters, derived from the grades query's section breakdown.\n */\nexport const useGradesHeadings = () => {\n  const { results } = useGradesData();\n  const { assignmentType, assignment: assignmentId } = useFilters();\n  return useMemo(() => {\n    const selectedAssignmentLabel = relevantAssignmentDataFromResults(results, assignmentId)?.label;\n    const sectionBreakdown = getAssignmentsFromResultsSubstate(results);\n    return headingMapper(\n      assignmentType || 'All',\n      selectedAssignmentLabel || 'All',\n    )(sectionBreakdown);\n  }, [results, assignmentType, assignmentId]);\n};\n\n/**\n * useSelectableAssignmentLabels()\n * The assignment options for the assignment dropdown, derived from the grades\n * results and filtered by the current assignment-type.\n */\nexport const useSelectableAssignmentLabels = () => {\n  const { results } = useGradesData();\n  const { assignmentType } = useFilters();\n  return useMemo(() => {\n    const all = getAssignmentsFromResultsSubstate(results)\n      .map(chooseRelevantAssignmentData);\n    return (assignmentType && assignmentType !== 'All')\n      ? all.filter((assignment) => assignment.type === assignmentType)\n      : all;\n  }, [results, assignmentType]);\n};\n\n/**\n * useSelectedAssignmentData()\n * The currently-selected assignment's data (label/type/id, from the grades\n * results), or undefined when no assignment is selected.\n */\nexport const useSelectedAssignmentData = () => {\n  const { results } = useGradesData();\n  const { assignment: assignmentId } = useFilters();\n  return useMemo(\n    () => relevantAssignmentDataFromResults(results, assignmentId),\n    [results, assignmentId],\n  );\n};\n\n/**\n * useSelectedAssignmentLabel()\n * The label of the currently-selected assignment (from the grades results).\n */\nexport const useSelectedAssignmentLabel = () => useSelectedAssignmentData()?.label;\n\n/**\n * useShouldShowSpinner()\n * The busy indicator: the roles gate combined with the grades query fetching or\n * any in-flight mutation (grade override save / CSV upload).\n */\nexport const useShouldShowSpinner = () => {\n  const canViewGradebook = useCanViewGradebook();\n  const { isFetching } = useGradesData();\n  const mutatingCount = useIsMutating();\n  return canViewGradebook && (isFetching || mutatingCount > 0);\n};\n\n/**\n * useAllGrades()\n * The (sorted) grades rows for the table.\n */\nexport const useAllGrades = () => useGradesData().results;\n\n/**\n * useUserCounts()\n * Filtered/total user counts from the grades query.\n */\nexport const useUserCounts = () => {\n  const { filteredUsersCount, totalUsersCount } = useGradesData();\n  return { filteredUsersCount, totalUsersCount };\n};\n\n/**\n * useGradeData()\n * The pagination cursors + counts (from the grades query) plus the current\n * `gradeFormat` (from the GradebookUi context).\n */\nexport const useGradeData = () => {\n  const {\n    nextPage, prevPage, totalUsersCount, filteredUsersCount,\n  } = useGradesData();\n  const { gradeFormat } = useGradebookUi();\n  return {\n    nextPage, prevPage, totalUsersCount, filteredUsersCount, gradeFormat,\n  };\n};\n\n// Export URL args, built from the FiltersProvider (applied grade limits + the\n// immediate filters) and the selected cohort name. Reuses the pure\n// `format*` helpers so the CSV/intervention URL formatting is unchanged.\nconst useLmsApiServiceArgs = () => {\n  const {\n    assignment, assignmentType, track, includeCourseRoleMembers,\n    appliedAssignmentGradeMin, appliedAssignmentGradeMax,\n    appliedCourseGradeMin, appliedCourseGradeMax,\n  } = useFilters();\n  const selectedCohort = useSelectedCohortEntry();\n  const assignmentId = assignment || undefined;\n  const opts = { assignmentId };\n  return {\n    cohort: selectedCohort ? selectedCohort.name : undefined,\n    track,\n    assignment: assignmentId,\n    assignmentType,\n    assignmentGradeMin: formatMinAssignmentGrade(appliedAssignmentGradeMin, opts),\n    assignmentGradeMax: formatMaxAssignmentGrade(appliedAssignmentGradeMax, opts),\n    courseGradeMin: formatMinCourseGrade(appliedCourseGradeMin),\n    courseGradeMax: formatMaxCourseGrade(appliedCourseGradeMax),\n    excludedCourseRoles: includeCourseRoleMembers ? '' : 'all',\n  };\n};\n\nexport const useGradeExportUrl = () => lms.urls.gradeCsvUrl(useLmsApiServiceArgs());\nexport const useInterventionExportUrl = () => lms.urls.interventionExportCsvUrl(useLmsApiServiceArgs());\n\n/**\n * useFilterBadgeConfig(filterName)\n * The badge config (value + isDefault) for a given filter, built from the\n * FiltersProvider (immediate filters + applied grade limits + query-derived\n * assignment label) and the selected cohort/track names. Reuses `filterConfig` +\n * the pure `selectors.filters.isDefault` so formatting is unchanged.\n */\nexport const useFilterBadgeConfig = (filterName) => {\n  const selectedCohort = useSelectedCohortEntry();\n  const selectedTrack = useSelectedTrackEntry();\n  const selectedAssignmentLabel = useSelectedAssignmentLabel();\n  const {\n    assignmentType, includeCourseRoleMembers,\n    appliedAssignmentGradeMin, appliedAssignmentGradeMax,\n    appliedCourseGradeMin, appliedCourseGradeMax,\n  } = useFilters();\n\n  if (filterName === filterNames.cohort || filterName === filterNames.track) {\n    const entry = filterName === filterNames.cohort ? selectedCohort : selectedTrack;\n    const value = entry ? entry.name : '';\n    return {\n      ...filterConfig[filterName],\n      value,\n      isDefault: value === initialFilters[filterName],\n    };\n  }\n\n  const { filterOrder, ...config } = filterConfig[filterName];\n\n  if (filterOrder) {\n    const [min, max] = filterName === filterNames.assignmentGrade\n      ? [appliedAssignmentGradeMin, appliedAssignmentGradeMax]\n      : [appliedCourseGradeMin, appliedCourseGradeMax];\n    return {\n      ...config,\n      value: `${min} - ${max}`,\n      isDefault: isDefault(filterOrder[0], min) && isDefault(filterOrder[1], max),\n    };\n  }\n\n  const singleValues = {\n    [filterNames.assignmentType]: assignmentType,\n    [filterNames.assignment]: selectedAssignmentLabel || '',\n    [filterNames.includeCourseRoleMembers]: includeCourseRoleMembers,\n  };\n  const value = singleValues[filterName];\n  return { ...config, value, isDefault: isDefault(filterName, value) };\n};\n\n/**\n * useGradeOverrideData()\n * The edit-modal override read-model, sourced from the override-history query\n * gated on the modal's subsection/user ids (from the GradebookUi context).\n */\nexport const useGradeOverrideData = () => {\n  const { modalState } = useGradebookUi();\n  const query = useGradeOverrideHistory(modalState.updateModuleId, modalState.updateUserId);\n  const { data } = query;\n  return {\n    gradeOverrideHistoryResults: data?.overrideHistory ?? EMPTY_ARRAY,\n    gradeOverrideCurrentEarnedGradedOverride: data?.currentEarnedGradedOverride ?? null,\n    gradeOriginalEarnedGraded: data?.originalGradeEarnedGraded ?? null,\n    gradeOriginalPossibleGraded: data?.originalGradePossibleGraded ?? null,\n    gradeOverrideHistoryError: query.isError ? (query.error?.message || '') : '',\n    hasOverrideErrors: query.isError,\n  };\n};\n\n/**\n * useEditModalPossibleGrade()\n * The edit-modal \"possible\" grade: the context `adjustedGradePossible` or, as a\n * fallback, the override query's original possible-graded value.\n */\nexport const useEditModalPossibleGrade = () => {\n  const { modalState } = useGradebookUi();\n  const { gradeOriginalPossibleGraded } = useGradeOverrideData();\n  return modalState.adjustedGradePossible || gradeOriginalPossibleGraded;\n};\n\n// Invalidate the main grades query, causing the mounted `useGrades` observer to\n// refetch with the current filters.\nconst useInvalidateGrades = () => {\n  const queryClient = useQueryClient();\n  const { courseId = '' } = useParams();\n  return () => queryClient.invalidateQueries({ queryKey: gradesQueryKeys.byCourse(courseId) });\n};\n\n/**\n * useRefetchGrades()\n * Refetches the grades query from the first (unpaged) page with the latest\n * filters. Always invalidates (the base-page cache entry may still be fresh, and\n * a fresh entry is served as-is when the key flips back to it); when on a\n * prev/next page, also clears the pagination cursor.\n */\nexport const useRefetchGrades = () => {\n  const invalidateGrades = useInvalidateGrades();\n  const { gradesPageEndpoint, setGradesPageEndpoint } = useGradebookUi();\n  return () => {\n    if (gradesPageEndpoint !== null) {\n      setGradesPageEndpoint(null);\n    }\n    invalidateGrades();\n  };\n};\n\n/**\n * useFetchGradesIfAssignmentGradeFiltersSet()\n * Refetches from the start only when a non-default applied assignment-grade limit\n * is set (mirrors the legacy `areAssignmentGradeFiltersSet` gate).\n */\nexport const useFetchGradesIfAssignmentGradeFiltersSet = () => {\n  const refetchFromStart = useRefetchGrades();\n  const { appliedAssignmentGradeMin, appliedAssignmentGradeMax } = useFilters();\n  return () => {\n    const isSet = appliedAssignmentGradeMin !== initialFilters.assignmentGradeMin\n      || appliedAssignmentGradeMax !== initialFilters.assignmentGradeMax;\n    if (isSet) {\n      refetchFromStart();\n    }\n  };\n};\n\n/**\n * useFetchPrevNextGrades()\n * Pagination trigger: sets the page cursor in the GradebookUi context (the\n * `useGrades` query keys off it and fetches that opaque prev/next URL).\n */\nexport const useFetchPrevNextGrades = () => {\n  const { setGradesPageEndpoint } = useGradebookUi();\n  return (endpoint) => {\n    setGradesPageEndpoint(endpoint);\n  };\n};\n"]}

package/dist/components/GradesView/data/queryKeys.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The main gradebook rows. The base key is a prefix of each paged key (see
+ * `useGrades`), so invalidating `byCourse(courseId)` refetches any page.
+ */
+export declare const gradesQueryKeys: {
+    all: readonly ["gradebook"];
+    byCourse: (courseId: string) => readonly ["gradebook", string, "grades"];
+};
+/** Grade-override history for one learner on one subsection (edit modal). */
+export declare const gradeOverrideHistoryQueryKeys: {
+    all: readonly ["gradebook", "gradeOverrideHistory"];
+    byCell: (subsectionId: string | null, userId: string | number | null) => readonly ["gradebook", "gradeOverrideHistory", string | null, string | number | null];
+};

package/dist/components/GradesView/data/queryKeys.js

@@ -0,0 +1,15 @@
+import { BASE_KEY } from '../../../data/queryKeys';
+/**
+ * The main gradebook rows. The base key is a prefix of each paged key (see
+ * `useGrades`), so invalidating `byCourse(courseId)` refetches any page.
+ */
+export const gradesQueryKeys = {
+    all: BASE_KEY,
+    byCourse: (courseId) => [...BASE_KEY, courseId, 'grades'],
+};
+/** Grade-override history for one learner on one subsection (edit modal). */
+export const gradeOverrideHistoryQueryKeys = {
+    all: [...BASE_KEY, 'gradeOverrideHistory'],
+    byCell: (subsectionId, userId) => [...BASE_KEY, 'gradeOverrideHistory', subsectionId, userId],
+};
+//# sourceMappingURL=queryKeys.js.map

package/dist/components/GradesView/data/queryKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryKeys.js","sourceRoot":"","sources":["../../../../src/components/GradesView/data/queryKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,QAAQ;IACb,QAAQ,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU;CAC3E,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,sBAAsB,CAAU;IACnD,MAAM,EAAE,CACN,YAA2B,EAC3B,MAA8B,EAC9B,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,CAAU;CAC1E,CAAC","sourcesContent":["import { BASE_KEY } from '@src/data/queryKeys';\n\n/**\n * The main gradebook rows. The base key is a prefix of each paged key (see\n * `useGrades`), so invalidating `byCourse(courseId)` refetches any page.\n */\nexport const gradesQueryKeys = {\n  all: BASE_KEY,\n  byCourse: (courseId: string) => [...BASE_KEY, courseId, 'grades'] as const,\n};\n\n/** Grade-override history for one learner on one subsection (edit modal). */\nexport const gradeOverrideHistoryQueryKeys = {\n  all: [...BASE_KEY, 'gradeOverrideHistory'] as const,\n  byCell: (\n    subsectionId: string | null,\n    userId: string | number | null,\n  ) => [...BASE_KEY, 'gradeOverrideHistory', subsectionId, userId] as const,\n};\n"]}