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

package/dist/data/filtersContext.js

@@ -0,0 +1,212 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, useRef, useState, } from 'react';
+import { useSearchParams } from 'react-router-dom';
+import initialFilters from './constants/filters';
+import { filtersSnapshot } from './filtersSnapshot';
+const FiltersContext = createContext(undefined);
+export const FiltersProvider = ({ children }) => {
+    const [searchParams] = useSearchParams();
+    // Initial values seeded from the URL query (mirrors the legacy
+    // `filters.initialize(urlQuery)`). Computed once.
+    const initialValues = useMemo(() => {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        return ({
+            assignmentType: (_a = searchParams.get('assignmentType')) !== null && _a !== void 0 ? _a : initialFilters.assignmentType,
+            assignment: (_b = searchParams.get('assignment')) !== null && _b !== void 0 ? _b : initialFilters.assignment,
+            includeCourseRoleMembers: searchParams.get('includeCourseRoleMembers') === 'true',
+            cohort: (_c = searchParams.get('cohort')) !== null && _c !== void 0 ? _c : initialFilters.cohort,
+            track: (_d = searchParams.get('track')) !== null && _d !== void 0 ? _d : initialFilters.track,
+            assignmentGradeMin: (_e = searchParams.get('assignmentGradeMin')) !== null && _e !== void 0 ? _e : initialFilters.assignmentGradeMin,
+            assignmentGradeMax: (_f = searchParams.get('assignmentGradeMax')) !== null && _f !== void 0 ? _f : initialFilters.assignmentGradeMax,
+            courseGradeMin: (_g = searchParams.get('courseGradeMin')) !== null && _g !== void 0 ? _g : initialFilters.courseGradeMin,
+            courseGradeMax: (_h = searchParams.get('courseGradeMax')) !== null && _h !== void 0 ? _h : initialFilters.courseGradeMax,
+            searchValue: '',
+            // eslint-disable-next-line react-hooks/exhaustive-deps
+        });
+    }, []);
+    // Seed the synchronous snapshot from the URL values on the first render, before
+    // the grades query (which reads it in its queryFn) fires — the query is gated on
+    // the roles query, so it resolves well after this. The wrapped setters below keep
+    // the snapshot in sync synchronously thereafter.
+    const snapshotSeeded = useRef(false);
+    if (!snapshotSeeded.current) {
+        Object.assign(filtersSnapshot, initialValues);
+        snapshotSeeded.current = true;
+    }
+    const [assignmentType, setAssignmentTypeState] = useState(initialValues.assignmentType);
+    const [assignment, setAssignmentState] = useState(initialValues.assignment);
+    const [includeCourseRoleMembers, setIncludeCourseRoleMembersState] = useState(initialValues.includeCourseRoleMembers);
+    const [cohort, setCohortState] = useState(initialValues.cohort);
+    const [track, setTrackState] = useState(initialValues.track);
+    // Grade-limit "live" values (previously the Redux `app.filters` sub-slice).
+    const [assignmentGradeMin, setAssignmentGradeMinState] = useState(initialValues.assignmentGradeMin);
+    const [assignmentGradeMax, setAssignmentGradeMaxState] = useState(initialValues.assignmentGradeMax);
+    const [courseGradeMin, setCourseGradeMinState] = useState(initialValues.courseGradeMin);
+    const [courseGradeMax, setCourseGradeMaxState] = useState(initialValues.courseGradeMax);
+    const [searchValue, setSearchValueState] = useState(initialValues.searchValue);
+    // Applied grade-limit values (committed on Apply). Seeded from the URL values, so
+    // on a deep link the badges/export match the initial fetch.
+    const [appliedAssignmentGradeMin, setAppliedAssignmentGradeMin] = useState(initialValues.assignmentGradeMin);
+    const [appliedAssignmentGradeMax, setAppliedAssignmentGradeMax] = useState(initialValues.assignmentGradeMax);
+    const [appliedCourseGradeMin, setAppliedCourseGradeMin] = useState(initialValues.courseGradeMin);
+    const [appliedCourseGradeMax, setAppliedCourseGradeMax] = useState(initialValues.courseGradeMax);
+    // Wrapped setters: update the synchronous snapshot first (so the grades queryFn
+    // reads the latest value at invalidate time), then the React state.
+    const setAssignmentType = useCallback((v) => {
+        filtersSnapshot.assignmentType = v;
+        setAssignmentTypeState(v);
+    }, []);
+    const setAssignment = useCallback((v) => {
+        filtersSnapshot.assignment = v;
+        setAssignmentState(v);
+    }, []);
+    const setIncludeCourseRoleMembers = useCallback((v) => {
+        filtersSnapshot.includeCourseRoleMembers = v;
+        setIncludeCourseRoleMembersState(v);
+    }, []);
+    const setCohort = useCallback((v) => {
+        filtersSnapshot.cohort = v;
+        setCohortState(v);
+    }, []);
+    const setTrack = useCallback((v) => {
+        filtersSnapshot.track = v;
+        setTrackState(v);
+    }, []);
+    // The grade-limit setters hold live (per-keystroke) input values, so they do
+    // NOT touch the snapshot: fetches must only ever see the applied values, which
+    // `applyAssignmentGradeLimits`/`applyCourseGradeLimits`/`resetFilters` commit
+    // to the snapshot below (matching the legacy split between the live `app`
+    // inputs and the apply-committed `filters` slice the fetch read).
+    const setAssignmentGradeMin = useCallback((v) => {
+        setAssignmentGradeMinState(v);
+    }, []);
+    const setAssignmentGradeMax = useCallback((v) => {
+        setAssignmentGradeMaxState(v);
+    }, []);
+    const setCourseGradeMin = useCallback((v) => {
+        setCourseGradeMinState(v);
+    }, []);
+    const setCourseGradeMax = useCallback((v) => {
+        setCourseGradeMaxState(v);
+    }, []);
+    const setSearchValue = useCallback((v) => {
+        filtersSnapshot.searchValue = v;
+        setSearchValueState(v);
+    }, []);
+    const applyAssignmentGradeLimits = useCallback(({ assignmentGradeMin: min, assignmentGradeMax: max }) => {
+        filtersSnapshot.assignmentGradeMin = min;
+        filtersSnapshot.assignmentGradeMax = max;
+        setAppliedAssignmentGradeMin(min);
+        setAppliedAssignmentGradeMax(max);
+    }, []);
+    const applyCourseGradeLimits = useCallback(({ courseGradeMin: min, courseGradeMax: max }) => {
+        filtersSnapshot.courseGradeMin = min;
+        filtersSnapshot.courseGradeMax = max;
+        setAppliedCourseGradeMin(min);
+        setAppliedCourseGradeMax(max);
+    }, []);
+    // Reset the named filters to their defaults (badge close). Mirrors the Redux
+    // `filters.reset`; also clears the applied grade-limit values so the badges/export
+    // update. The wrapped setters keep the snapshot in sync for the grades fetch.
+    const resetFilters = useCallback((filterNames) => {
+        filterNames.forEach((name) => {
+            switch (name) {
+                case 'assignmentType':
+                    setAssignmentType(initialFilters.assignmentType);
+                    break;
+                case 'assignment':
+                    setAssignment(initialFilters.assignment);
+                    break;
+                case 'cohort':
+                    setCohort(initialFilters.cohort);
+                    break;
+                case 'track':
+                    setTrack(initialFilters.track);
+                    break;
+                case 'includeCourseRoleMembers':
+                    setIncludeCourseRoleMembers(initialFilters.includeCourseRoleMembers);
+                    break;
+                case 'assignmentGradeMin':
+                    filtersSnapshot.assignmentGradeMin = initialFilters.assignmentGradeMin;
+                    setAssignmentGradeMin(initialFilters.assignmentGradeMin);
+                    setAppliedAssignmentGradeMin(initialFilters.assignmentGradeMin);
+                    break;
+                case 'assignmentGradeMax':
+                    filtersSnapshot.assignmentGradeMax = initialFilters.assignmentGradeMax;
+                    setAssignmentGradeMax(initialFilters.assignmentGradeMax);
+                    setAppliedAssignmentGradeMax(initialFilters.assignmentGradeMax);
+                    break;
+                case 'courseGradeMin':
+                    filtersSnapshot.courseGradeMin = initialFilters.courseGradeMin;
+                    setCourseGradeMin(initialFilters.courseGradeMin);
+                    setAppliedCourseGradeMin(initialFilters.courseGradeMin);
+                    break;
+                case 'courseGradeMax':
+                    filtersSnapshot.courseGradeMax = initialFilters.courseGradeMax;
+                    setCourseGradeMax(initialFilters.courseGradeMax);
+                    setAppliedCourseGradeMax(initialFilters.courseGradeMax);
+                    break;
+                default: break;
+            }
+        });
+    }, [
+        setAssignmentType, setAssignment, setCohort, setTrack, setIncludeCourseRoleMembers,
+        setAssignmentGradeMin, setAssignmentGradeMax, setCourseGradeMin, setCourseGradeMax,
+    ]);
+    const value = useMemo(() => ({
+        assignmentType,
+        setAssignmentType,
+        assignment,
+        setAssignment,
+        includeCourseRoleMembers,
+        setIncludeCourseRoleMembers,
+        cohort,
+        setCohort,
+        track,
+        setTrack,
+        assignmentGradeMin,
+        setAssignmentGradeMin,
+        assignmentGradeMax,
+        setAssignmentGradeMax,
+        courseGradeMin,
+        setCourseGradeMin,
+        courseGradeMax,
+        setCourseGradeMax,
+        searchValue,
+        setSearchValue,
+        appliedAssignmentGradeMin,
+        appliedAssignmentGradeMax,
+        appliedCourseGradeMin,
+        appliedCourseGradeMax,
+        applyAssignmentGradeLimits,
+        applyCourseGradeLimits,
+        resetFilters,
+    }), [
+        assignmentType, assignment, includeCourseRoleMembers, cohort, track,
+        assignmentGradeMin, assignmentGradeMax, courseGradeMin, courseGradeMax,
+        searchValue,
+        appliedAssignmentGradeMin, appliedAssignmentGradeMax,
+        appliedCourseGradeMin, appliedCourseGradeMax,
+        // Wrapped setters + apply ops are stable (useCallback []) but listed to
+        // satisfy exhaustive-deps:
+        setAssignmentType, setAssignment, setIncludeCourseRoleMembers, setCohort,
+        setTrack, setAssignmentGradeMin, setAssignmentGradeMax, setCourseGradeMin,
+        setCourseGradeMax, setSearchValue,
+        applyAssignmentGradeLimits, applyCourseGradeLimits, resetFilters,
+    ]);
+    return (_jsx(FiltersContext.Provider, { value: value, children: children }));
+};
+/**
+ * useFilters()
+ * Accessor for the gradebook filter context. Throws if used outside a
+ * <FiltersProvider>.
+ */
+export const useFilters = () => {
+    const context = useContext(FiltersContext);
+    if (context === undefined) {
+        throw new Error('useFilters must be used within a FiltersProvider');
+    }
+    return context;
+};
+export default FiltersContext;
+//# sourceMappingURL=filtersContext.js.map

package/dist/data/filtersContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtersContext.js","sourceRoot":"","sources":["../../src/data/filtersContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, {\n  createContext, useCallback, useContext, useMemo, useRef, useState,\n} from 'react';\nimport { useSearchParams } from 'react-router-dom';\n\nimport initialFilters from '@src/data/constants/filters';\nimport { filtersSnapshot } from '@src/data/filtersSnapshot';\n\n/**\n * Client-side gradebook filter state, held in React (Context + useState).\n *\n * Replaces the Redux `filters` slice (and the live grade-limit inputs from the\n * `app` slice). The provider also mirrors the fetch-relevant values into the\n * synchronous `filtersSnapshot`, which the grades queryFn reads at fetch time.\n */\nexport interface FiltersContextValue {\n  assignmentType: string;\n  setAssignmentType: (value: string) => void;\n  // The selected assignment id; the label/type are derived from the grades\n  // query results.\n  assignment: string;\n  setAssignment: (value: string) => void;\n  includeCourseRoleMembers: boolean;\n  setIncludeCourseRoleMembers: (value: boolean) => void;\n  cohort: string;\n  setCohort: (value: string) => void;\n  track: string;\n  setTrack: (value: string) => void;\n  assignmentGradeMin: string;\n  setAssignmentGradeMin: (value: string) => void;\n  assignmentGradeMax: string;\n  setAssignmentGradeMax: (value: string) => void;\n  courseGradeMin: string;\n  setCourseGradeMin: (value: string) => void;\n  courseGradeMax: string;\n  setCourseGradeMax: (value: string) => void;\n  // Username/email search text (was Redux `app.searchValue`). Not persisted in the\n  // URL, so it starts empty.\n  searchValue: string;\n  setSearchValue: (value: string) => void;\n  // Applied (committed-on-Apply) grade-limit values. The setters above hold the\n  // \"live\" input values (per keystroke); these hold what was last applied and are\n  // what the filter badges + export URLs reflect (was the Redux `filters` slice\n  // grade limits, set by `update.assignmentLimits`/`update.courseGradeLimits`).\n  appliedAssignmentGradeMin: string;\n  appliedAssignmentGradeMax: string;\n  appliedCourseGradeMin: string;\n  appliedCourseGradeMax: string;\n  applyAssignmentGradeLimits: (limits: { assignmentGradeMin: string; assignmentGradeMax: string }) => void;\n  applyCourseGradeLimits: (limits: { courseGradeMin: string; courseGradeMax: string }) => void;\n  /**\n   * Reset the given filter names to their defaults (used by the active-filter\n   * badge close buttons). Resets both the live and applied grade-limit values.\n   * Was the Redux `filters.reset` action.\n   */\n  resetFilters: (filterNames: string[]) => void;\n}\n\nconst FiltersContext = createContext<FiltersContextValue | undefined>(undefined);\n\ninterface FiltersProviderProps {\n  children: React.ReactNode;\n}\n\nexport const FiltersProvider = ({ children }: FiltersProviderProps) => {\n  const [searchParams] = useSearchParams();\n  // Initial values seeded from the URL query (mirrors the legacy\n  // `filters.initialize(urlQuery)`). Computed once.\n  const initialValues = useMemo(() => ({\n    assignmentType: searchParams.get('assignmentType') ?? initialFilters.assignmentType,\n    assignment: searchParams.get('assignment') ?? initialFilters.assignment,\n    includeCourseRoleMembers: searchParams.get('includeCourseRoleMembers') === 'true',\n    cohort: searchParams.get('cohort') ?? initialFilters.cohort,\n    track: searchParams.get('track') ?? initialFilters.track,\n    assignmentGradeMin: searchParams.get('assignmentGradeMin') ?? initialFilters.assignmentGradeMin,\n    assignmentGradeMax: searchParams.get('assignmentGradeMax') ?? initialFilters.assignmentGradeMax,\n    courseGradeMin: searchParams.get('courseGradeMin') ?? initialFilters.courseGradeMin,\n    courseGradeMax: searchParams.get('courseGradeMax') ?? initialFilters.courseGradeMax,\n    searchValue: '',\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }), []);\n\n  // Seed the synchronous snapshot from the URL values on the first render, before\n  // the grades query (which reads it in its queryFn) fires — the query is gated on\n  // the roles query, so it resolves well after this. The wrapped setters below keep\n  // the snapshot in sync synchronously thereafter.\n  const snapshotSeeded = useRef(false);\n  if (!snapshotSeeded.current) {\n    Object.assign(filtersSnapshot, initialValues);\n    snapshotSeeded.current = true;\n  }\n\n  const [assignmentType, setAssignmentTypeState] = useState<string>(initialValues.assignmentType);\n  const [assignment, setAssignmentState] = useState<string>(initialValues.assignment);\n  const [includeCourseRoleMembers, setIncludeCourseRoleMembersState] = useState<boolean>(\n    initialValues.includeCourseRoleMembers,\n  );\n  const [cohort, setCohortState] = useState<string>(initialValues.cohort);\n  const [track, setTrackState] = useState<string>(initialValues.track);\n  // Grade-limit \"live\" values (previously the Redux `app.filters` sub-slice).\n  const [assignmentGradeMin, setAssignmentGradeMinState] = useState<string>(\n    initialValues.assignmentGradeMin,\n  );\n  const [assignmentGradeMax, setAssignmentGradeMaxState] = useState<string>(\n    initialValues.assignmentGradeMax,\n  );\n  const [courseGradeMin, setCourseGradeMinState] = useState<string>(initialValues.courseGradeMin);\n  const [courseGradeMax, setCourseGradeMaxState] = useState<string>(initialValues.courseGradeMax);\n  const [searchValue, setSearchValueState] = useState<string>(initialValues.searchValue);\n\n  // Applied grade-limit values (committed on Apply). Seeded from the URL values, so\n  // on a deep link the badges/export match the initial fetch.\n  const [appliedAssignmentGradeMin, setAppliedAssignmentGradeMin] = useState<string>(\n    initialValues.assignmentGradeMin,\n  );\n  const [appliedAssignmentGradeMax, setAppliedAssignmentGradeMax] = useState<string>(\n    initialValues.assignmentGradeMax,\n  );\n  const [appliedCourseGradeMin, setAppliedCourseGradeMin] = useState<string>(\n    initialValues.courseGradeMin,\n  );\n  const [appliedCourseGradeMax, setAppliedCourseGradeMax] = useState<string>(\n    initialValues.courseGradeMax,\n  );\n\n  // Wrapped setters: update the synchronous snapshot first (so the grades queryFn\n  // reads the latest value at invalidate time), then the React state.\n  const setAssignmentType = useCallback((v: string) => {\n    filtersSnapshot.assignmentType = v;\n    setAssignmentTypeState(v);\n  }, []);\n  const setAssignment = useCallback((v: string) => {\n    filtersSnapshot.assignment = v;\n    setAssignmentState(v);\n  }, []);\n  const setIncludeCourseRoleMembers = useCallback((v: boolean) => {\n    filtersSnapshot.includeCourseRoleMembers = v;\n    setIncludeCourseRoleMembersState(v);\n  }, []);\n  const setCohort = useCallback((v: string) => {\n    filtersSnapshot.cohort = v;\n    setCohortState(v);\n  }, []);\n  const setTrack = useCallback((v: string) => {\n    filtersSnapshot.track = v;\n    setTrackState(v);\n  }, []);\n  // The grade-limit setters hold live (per-keystroke) input values, so they do\n  // NOT touch the snapshot: fetches must only ever see the applied values, which\n  // `applyAssignmentGradeLimits`/`applyCourseGradeLimits`/`resetFilters` commit\n  // to the snapshot below (matching the legacy split between the live `app`\n  // inputs and the apply-committed `filters` slice the fetch read).\n  const setAssignmentGradeMin = useCallback((v: string) => {\n    setAssignmentGradeMinState(v);\n  }, []);\n  const setAssignmentGradeMax = useCallback((v: string) => {\n    setAssignmentGradeMaxState(v);\n  }, []);\n  const setCourseGradeMin = useCallback((v: string) => {\n    setCourseGradeMinState(v);\n  }, []);\n  const setCourseGradeMax = useCallback((v: string) => {\n    setCourseGradeMaxState(v);\n  }, []);\n  const setSearchValue = useCallback((v: string) => {\n    filtersSnapshot.searchValue = v;\n    setSearchValueState(v);\n  }, []);\n\n  const applyAssignmentGradeLimits = useCallback(\n    ({ assignmentGradeMin: min, assignmentGradeMax: max }: {\n      assignmentGradeMin: string; assignmentGradeMax: string;\n    }) => {\n      filtersSnapshot.assignmentGradeMin = min;\n      filtersSnapshot.assignmentGradeMax = max;\n      setAppliedAssignmentGradeMin(min);\n      setAppliedAssignmentGradeMax(max);\n    },\n    [],\n  );\n  const applyCourseGradeLimits = useCallback(\n    ({ courseGradeMin: min, courseGradeMax: max }: {\n      courseGradeMin: string; courseGradeMax: string;\n    }) => {\n      filtersSnapshot.courseGradeMin = min;\n      filtersSnapshot.courseGradeMax = max;\n      setAppliedCourseGradeMin(min);\n      setAppliedCourseGradeMax(max);\n    },\n    [],\n  );\n\n  // Reset the named filters to their defaults (badge close). Mirrors the Redux\n  // `filters.reset`; also clears the applied grade-limit values so the badges/export\n  // update. The wrapped setters keep the snapshot in sync for the grades fetch.\n  const resetFilters = useCallback((filterNames: string[]) => {\n    filterNames.forEach((name) => {\n      switch (name) {\n        case 'assignmentType':\n          setAssignmentType(initialFilters.assignmentType);\n          break;\n        case 'assignment':\n          setAssignment(initialFilters.assignment);\n          break;\n        case 'cohort':\n          setCohort(initialFilters.cohort);\n          break;\n        case 'track':\n          setTrack(initialFilters.track);\n          break;\n        case 'includeCourseRoleMembers':\n          setIncludeCourseRoleMembers(initialFilters.includeCourseRoleMembers);\n          break;\n        case 'assignmentGradeMin':\n          filtersSnapshot.assignmentGradeMin = initialFilters.assignmentGradeMin;\n          setAssignmentGradeMin(initialFilters.assignmentGradeMin);\n          setAppliedAssignmentGradeMin(initialFilters.assignmentGradeMin);\n          break;\n        case 'assignmentGradeMax':\n          filtersSnapshot.assignmentGradeMax = initialFilters.assignmentGradeMax;\n          setAssignmentGradeMax(initialFilters.assignmentGradeMax);\n          setAppliedAssignmentGradeMax(initialFilters.assignmentGradeMax);\n          break;\n        case 'courseGradeMin':\n          filtersSnapshot.courseGradeMin = initialFilters.courseGradeMin;\n          setCourseGradeMin(initialFilters.courseGradeMin);\n          setAppliedCourseGradeMin(initialFilters.courseGradeMin);\n          break;\n        case 'courseGradeMax':\n          filtersSnapshot.courseGradeMax = initialFilters.courseGradeMax;\n          setCourseGradeMax(initialFilters.courseGradeMax);\n          setAppliedCourseGradeMax(initialFilters.courseGradeMax);\n          break;\n        default: break;\n      }\n    });\n  }, [\n    setAssignmentType, setAssignment, setCohort, setTrack, setIncludeCourseRoleMembers,\n    setAssignmentGradeMin, setAssignmentGradeMax, setCourseGradeMin, setCourseGradeMax,\n  ]);\n\n  const value = useMemo<FiltersContextValue>(\n    () => ({\n      assignmentType,\n      setAssignmentType,\n      assignment,\n      setAssignment,\n      includeCourseRoleMembers,\n      setIncludeCourseRoleMembers,\n      cohort,\n      setCohort,\n      track,\n      setTrack,\n      assignmentGradeMin,\n      setAssignmentGradeMin,\n      assignmentGradeMax,\n      setAssignmentGradeMax,\n      courseGradeMin,\n      setCourseGradeMin,\n      courseGradeMax,\n      setCourseGradeMax,\n      searchValue,\n      setSearchValue,\n      appliedAssignmentGradeMin,\n      appliedAssignmentGradeMax,\n      appliedCourseGradeMin,\n      appliedCourseGradeMax,\n      applyAssignmentGradeLimits,\n      applyCourseGradeLimits,\n      resetFilters,\n    }),\n    [\n      assignmentType, assignment, includeCourseRoleMembers, cohort, track,\n      assignmentGradeMin, assignmentGradeMax, courseGradeMin, courseGradeMax,\n      searchValue,\n      appliedAssignmentGradeMin, appliedAssignmentGradeMax,\n      appliedCourseGradeMin, appliedCourseGradeMax,\n      // Wrapped setters + apply ops are stable (useCallback []) but listed to\n      // satisfy exhaustive-deps:\n      setAssignmentType, setAssignment, setIncludeCourseRoleMembers, setCohort,\n      setTrack, setAssignmentGradeMin, setAssignmentGradeMax, setCourseGradeMin,\n      setCourseGradeMax, setSearchValue,\n      applyAssignmentGradeLimits, applyCourseGradeLimits, resetFilters,\n    ],\n  );\n\n  return (\n    <FiltersContext.Provider value={value}>\n      {children}\n    </FiltersContext.Provider>\n  );\n};\n\n/**\n * useFilters()\n * Accessor for the gradebook filter context. Throws if used outside a\n * <FiltersProvider>.\n */\nexport const useFilters = (): FiltersContextValue => {\n  const context = useContext(FiltersContext);\n  if (context === undefined) {\n    throw new Error('useFilters must be used within a FiltersProvider');\n  }\n  return context;\n};\n\nexport default FiltersContext;\n"]}

package/dist/data/filtersSnapshot.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Synchronous mirror of the `FiltersProvider` filter values, read by the grades
+ * queryFn at fetch time. The grade-limit values mirror the APPLIED limits (they
+ * are only committed on apply/reset), not the live input values.
+ */
+export interface FiltersSnapshot {
+    assignmentType: string;
+    /** Selected assignment id (the label/type are derived from the query results). */
+    assignment: string;
+    includeCourseRoleMembers: boolean;
+    cohort: string;
+    track: string;
+    assignmentGradeMin: string;
+    assignmentGradeMax: string;
+    courseGradeMin: string;
+    courseGradeMax: string;
+    searchValue: string;
+}
+export declare const filtersSnapshot: FiltersSnapshot;
+export default filtersSnapshot;

package/dist/data/filtersSnapshot.js

@@ -0,0 +1,15 @@
+import initialFilters from './constants/filters';
+export const filtersSnapshot = {
+    assignmentType: initialFilters.assignmentType,
+    assignment: initialFilters.assignment,
+    includeCourseRoleMembers: initialFilters.includeCourseRoleMembers,
+    cohort: initialFilters.cohort,
+    track: initialFilters.track,
+    assignmentGradeMin: initialFilters.assignmentGradeMin,
+    assignmentGradeMax: initialFilters.assignmentGradeMax,
+    courseGradeMin: initialFilters.courseGradeMin,
+    courseGradeMax: initialFilters.courseGradeMax,
+    searchValue: '',
+};
+export default filtersSnapshot;
+//# sourceMappingURL=filtersSnapshot.js.map

package/dist/data/filtersSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtersSnapshot.js","sourceRoot":"","sources":["../../src/data/filtersSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,6BAA6B,CAAC;AAsBzD,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,cAAc,EAAE,cAAc,CAAC,cAAc;IAC7C,UAAU,EAAE,cAAc,CAAC,UAAU;IACrC,wBAAwB,EAAE,cAAc,CAAC,wBAAwB;IACjE,MAAM,EAAE,cAAc,CAAC,MAAM;IAC7B,KAAK,EAAE,cAAc,CAAC,KAAK;IAC3B,kBAAkB,EAAE,cAAc,CAAC,kBAAkB;IACrD,kBAAkB,EAAE,cAAc,CAAC,kBAAkB;IACrD,cAAc,EAAE,cAAc,CAAC,cAAc;IAC7C,cAAc,EAAE,cAAc,CAAC,cAAc;IAC7C,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,eAAe,eAAe,CAAC","sourcesContent":["import initialFilters from '@src/data/constants/filters';\n\n/**\n * Synchronous mirror of the `FiltersProvider` filter values, read by the grades\n * queryFn at fetch time. The grade-limit values mirror the APPLIED limits (they\n * are only committed on apply/reset), not the live input values.\n */\n\nexport interface FiltersSnapshot {\n  assignmentType: string;\n  /** Selected assignment id (the label/type are derived from the query results). */\n  assignment: string;\n  includeCourseRoleMembers: boolean;\n  cohort: string;\n  track: string;\n  assignmentGradeMin: string;\n  assignmentGradeMax: string;\n  courseGradeMin: string;\n  courseGradeMax: string;\n  searchValue: string;\n}\n\nexport const filtersSnapshot: FiltersSnapshot = {\n  assignmentType: initialFilters.assignmentType,\n  assignment: initialFilters.assignment,\n  includeCourseRoleMembers: initialFilters.includeCourseRoleMembers,\n  cohort: initialFilters.cohort,\n  track: initialFilters.track,\n  assignmentGradeMin: initialFilters.assignmentGradeMin,\n  assignmentGradeMax: initialFilters.assignmentGradeMax,\n  courseGradeMin: initialFilters.courseGradeMin,\n  courseGradeMax: initialFilters.courseGradeMax,\n  searchValue: '',\n};\n\nexport default filtersSnapshot;\n"]}

package/dist/data/formatUtils.d.ts

@@ -0,0 +1,15 @@
+export namespace options {
+    let year: string;
+    let month: string;
+    let day: string;
+    let timeZone: string;
+}
+export namespace timeOptions {
+    export let hour: string;
+    export let minute: string;
+    let timeZone_1: string;
+    export { timeZone_1 as timeZone };
+    export let timeZoneName: string;
+}
+export function formatDateForDisplay(inputDate: any): string;
+export function sortAlphaAsc(gradeRowA: any, gradeRowB: any): 1 | -1 | 0;

package/dist/data/formatUtils.js

@@ -0,0 +1,35 @@
+// Pure, framework-agnostic formatting helpers used by the live data layer. These
+// were previously exported from `data/actions/utils.js` (a Redux module that also
+// imported `@reduxjs/toolkit`); they are relocated here so the runtime path no
+// longer pulls Redux in. Logic is unchanged.
+export const options = {
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+    timeZone: 'UTC',
+};
+export const timeOptions = {
+    hour: '2-digit',
+    minute: '2-digit',
+    timeZone: 'UTC',
+    timeZoneName: 'short',
+};
+/** Formats a Date as "Month D, YYYY at HH:MM TZ" (UTC), for history/modal display. */
+export const formatDateForDisplay = (inputDate) => {
+    const date = inputDate.toLocaleDateString('en-US', options);
+    const time = inputDate.toLocaleTimeString('en-US', timeOptions);
+    return `${date} at ${time}`;
+};
+/** Case-insensitive comparator sorting grade rows by username (ascending). */
+export const sortAlphaAsc = (gradeRowA, gradeRowB) => {
+    const a = gradeRowA.username.toUpperCase();
+    const b = gradeRowB.username.toUpperCase();
+    if (a < b) {
+        return -1;
+    }
+    if (a > b) {
+        return 1;
+    }
+    return 0;
+};
+//# sourceMappingURL=formatUtils.js.map

package/dist/data/formatUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatUtils.js","sourceRoot":"","sources":["../../src/data/formatUtils.js"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kFAAkF;AAClF,+EAA+E;AAC/E,6CAA6C;AAE7C,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,KAAK;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,OAAO;CACtB,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,EAAE;IAChD,MAAM,IAAI,GAAG,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAChE,OAAO,GAAG,IAAI,OAAO,IAAI,EAAE,CAAC;AAC9B,CAAC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE;IACnD,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACV,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACV,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC","sourcesContent":["// Pure, framework-agnostic formatting helpers used by the live data layer. These\n// were previously exported from `data/actions/utils.js` (a Redux module that also\n// imported `@reduxjs/toolkit`); they are relocated here so the runtime path no\n// longer pulls Redux in. Logic is unchanged.\n\nexport const options = {\n  year: 'numeric',\n  month: 'long',\n  day: 'numeric',\n  timeZone: 'UTC',\n};\n\nexport const timeOptions = {\n  hour: '2-digit',\n  minute: '2-digit',\n  timeZone: 'UTC',\n  timeZoneName: 'short',\n};\n\n/** Formats a Date as \"Month D, YYYY at HH:MM TZ\" (UTC), for history/modal display. */\nexport const formatDateForDisplay = (inputDate) => {\n  const date = inputDate.toLocaleDateString('en-US', options);\n  const time = inputDate.toLocaleTimeString('en-US', timeOptions);\n  return `${date} at ${time}`;\n};\n\n/** Case-insensitive comparator sorting grade rows by username (ascending). */\nexport const sortAlphaAsc = (gradeRowA, gradeRowB) => {\n  const a = gradeRowA.username.toUpperCase();\n  const b = gradeRowB.username.toUpperCase();\n  if (a < b) {\n    return -1;\n  }\n  if (a > b) {\n    return 1;\n  }\n  return 0;\n};\n"]}

package/dist/data/gradebookUiContext.d.ts

@@ -0,0 +1,99 @@
+import React from 'react';
+/** Edit-grade modal state (was the Redux `app.modalState` slice). */
+export interface ModalState {
+    open: boolean;
+    adjustedGradePossible: string | number;
+    adjustedGradeValue: string | number;
+    assignmentName: string;
+    reasonForChange: string;
+    todaysDate: string;
+    updateModuleId: string | null;
+    updateUserId: number | null;
+    updateUserName: string | null;
+}
+/** Payload for opening the modal from a grade-table cell. */
+export interface ModalStateFromTablePayload {
+    subsection: {
+        attempted?: boolean;
+        score_possible?: number;
+        subsection_name?: string;
+        module_id?: string;
+    };
+    userEntry: {
+        user_id?: number;
+        username?: string;
+    };
+}
+/**
+ * Client-side gradebook **UI** state, held in React (Context + useState).
+ *
+ * Replaces the non-filter UI bits of the old Redux `app` and `grades` slices:
+ * grade format toggle, success banner, import toast, active view, filter-menu
+ * open/transition, modal state, pagination cursor, and CSV-upload feedback.
+ */
+export interface GradebookUiContextValue {
+    /** Grade display format: 'percent' | 'absolute'. */
+    gradeFormat: string;
+    setGradeFormat: (value: string) => void;
+    /** Success banner shown after a grade override is saved. */
+    showSuccess: boolean;
+    setShowSuccess: (value: boolean) => void;
+    /** Toast shown after a successful bulk grade CSV import. */
+    showImportSuccessToast: boolean;
+    setShowImportSuccessToast: (value: boolean) => void;
+    /** Active top-level tab: views.grades | views.bulkManagementHistory. */
+    activeView: string;
+    setActiveView: (value: string) => void;
+    /**
+     * Filter sidebar open/close state, with the same two-phase transition the old
+     * Redux `app.filterMenu` slice modeled (`open` + `transitioning`). Consumers
+     * derive `isClosed`/`isOpening` from these two.
+     */
+    filterMenuOpen: boolean;
+    filterMenuTransitioning: boolean;
+    /** Toggle the sidebar (starts the transition, flips `open` on the next frame). */
+    toggleFilterMenu: () => void;
+    /** Close the sidebar if it is currently open (no-op otherwise). */
+    closeFilterMenu: () => void;
+    /** onTransitionEnd handler for the sidebar; ends the transition phase. */
+    handleFilterMenuTransitionEnd: (event: React.TransitionEvent) => void;
+    /** Edit-grade modal state (was Redux `app.modalState`). */
+    modalState: ModalState;
+    /** Merge a partial update into modalState (filtered to the known modal fields). */
+    setModalState: (partial: Partial<ModalState>) => void;
+    /** Open the modal seeded from a grade-table cell (subsection + user entry). */
+    setModalStateFromTable: (payload: ModalStateFromTablePayload) => void;
+    /** Reset the modal to its initial (closed) state. */
+    closeModal: () => void;
+    /**
+     * Current grades pagination cursor: the opaque prev/next URL from the last
+     * grades response, or null for the first (unpaged) page. Held here so the
+     * `useGrades` query can key/refetch off it; filter changes reset it to null.
+     */
+    gradesPageEndpoint: string | null;
+    setGradesPageEndpoint: (endpoint: string | null) => void;
+    /**
+     * Bulk grade CSV-upload result feedback shown by `BulkManagementAlerts` (was the
+     * Redux `grades.bulkManagement` `uploadSuccess`/`errorMessages`).
+     */
+    csvUploadSuccess: boolean;
+    csvUploadErrorMessages: string[];
+    /** Reset the CSV-upload feedback (upload started). */
+    resetCsvUpload: () => void;
+    /** Mark the CSV upload succeeded. */
+    markCsvUploadSuccess: () => void;
+    /** Record CSV-upload error messages. */
+    setCsvUploadErrors: (messages: string[]) => void;
+}
+declare const GradebookUiContext: React.Context<GradebookUiContextValue | undefined>;
+interface GradebookUiProviderProps {
+    children: React.ReactNode;
+}
+export declare const GradebookUiProvider: ({ children }: GradebookUiProviderProps) => React.JSX.Element;
+/**
+ * useGradebookUi()
+ * Accessor for the gradebook UI-state context. Throws if used outside a
+ * <GradebookUiProvider>.
+ */
+export declare const useGradebookUi: () => GradebookUiContextValue;
+export default GradebookUiContext;

package/dist/data/gradebookUiContext.js

@@ -0,0 +1,143 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { views, modalFieldKeys } from './constants/app';
+import { formatDateForDisplay } from './formatUtils';
+// Mirrors the Redux `app` reducer's `initialState.modalState`.
+const initialModalState = {
+    open: false,
+    adjustedGradePossible: '',
+    adjustedGradeValue: 0,
+    assignmentName: '',
+    reasonForChange: '',
+    todaysDate: '',
+    updateModuleId: null,
+    updateUserId: null,
+    updateUserName: null,
+};
+const GradebookUiContext = createContext(undefined);
+export const GradebookUiProvider = ({ children }) => {
+    const [gradeFormat, setGradeFormat] = useState('percent');
+    const [showSuccess, setShowSuccess] = useState(false);
+    const [showImportSuccessToast, setShowImportSuccessToast] = useState(false);
+    const [activeView, setActiveView] = useState(views.grades);
+    // Filter sidebar animation state. This mirrors the old Redux `filterMenu` thunks:
+    // `toggle` flips `open` one frame after starting the transition, and the sidebar's
+    // onTransitionEnd ends the transition. `close` reads the latest `open` via a ref
+    // so it can be a stable callback.
+    const [filterMenuOpen, setFilterMenuOpen] = useState(false);
+    const [filterMenuTransitioning, setFilterMenuTransitioning] = useState(false);
+    const filterMenuOpenRef = useRef(filterMenuOpen);
+    useEffect(() => {
+        filterMenuOpenRef.current = filterMenuOpen;
+    }, [filterMenuOpen]);
+    const toggleFilterMenu = useCallback(() => {
+        setFilterMenuTransitioning(true);
+        window.requestAnimationFrame(() => {
+            window.setTimeout(() => {
+                setFilterMenuOpen((open) => !open);
+            });
+        });
+    }, []);
+    const closeFilterMenu = useCallback(() => {
+        if (filterMenuOpenRef.current) {
+            toggleFilterMenu();
+        }
+    }, [toggleFilterMenu]);
+    const handleFilterMenuTransitionEnd = useCallback((event) => {
+        if (event.currentTarget === event.target) {
+            setFilterMenuTransitioning(false);
+        }
+    }, []);
+    // Edit-grade modal state. These ops are a faithful port of the Redux `app`
+    // reducer cases: `setModalState` merges a field-filtered partial, `closeModal`
+    // resets to the initial state, and `setModalStateFromTable` opens the modal
+    // seeded from the clicked grade cell.
+    const [modalState, setModalStateValue] = useState(initialModalState);
+    const setModalState = useCallback((partial) => {
+        const filtered = Object.keys(modalFieldKeys).reduce((obj, key) => (partial[key] !== undefined ? Object.assign(Object.assign({}, obj), { [key]: partial[key] }) : obj), {});
+        setModalStateValue((prev) => (Object.assign(Object.assign({}, prev), filtered)));
+    }, []);
+    const setModalStateFromTable = useCallback(({ subsection, userEntry }) => {
+        var _a, _b, _c, _d;
+        setModalStateValue({
+            open: true,
+            adjustedGradeValue: '',
+            reasonForChange: '',
+            todaysDate: formatDateForDisplay(new Date()),
+            adjustedGradePossible: subsection.attempted ? ((_a = subsection.score_possible) !== null && _a !== void 0 ? _a : '') : '',
+            assignmentName: `${subsection.subsection_name}`,
+            updateModuleId: (_b = subsection.module_id) !== null && _b !== void 0 ? _b : null,
+            updateUserId: (_c = userEntry.user_id) !== null && _c !== void 0 ? _c : null,
+            updateUserName: (_d = userEntry.username) !== null && _d !== void 0 ? _d : null,
+        });
+    }, []);
+    const closeModal = useCallback(() => {
+        setModalStateValue(initialModalState);
+    }, []);
+    // Grades pagination cursor (opaque prev/next URL, or null for the first page).
+    const [gradesPageEndpoint, setGradesPageEndpoint] = useState(null);
+    // Bulk CSV-upload result feedback (was Redux `grades.bulkManagement`).
+    const [csvUploadSuccess, setCsvUploadSuccess] = useState(false);
+    const [csvUploadErrorMessages, setCsvUploadErrorMessages] = useState([]);
+    const resetCsvUpload = useCallback(() => {
+        setCsvUploadSuccess(false);
+        setCsvUploadErrorMessages([]);
+    }, []);
+    const markCsvUploadSuccess = useCallback(() => {
+        setCsvUploadSuccess(true);
+        setCsvUploadErrorMessages([]);
+    }, []);
+    const setCsvUploadErrors = useCallback((messages) => {
+        setCsvUploadSuccess(false);
+        setCsvUploadErrorMessages(messages);
+    }, []);
+    const value = useMemo(() => ({
+        gradeFormat,
+        setGradeFormat,
+        showSuccess,
+        setShowSuccess,
+        showImportSuccessToast,
+        setShowImportSuccessToast,
+        activeView,
+        setActiveView,
+        filterMenuOpen,
+        filterMenuTransitioning,
+        toggleFilterMenu,
+        closeFilterMenu,
+        handleFilterMenuTransitionEnd,
+        modalState,
+        setModalState,
+        setModalStateFromTable,
+        closeModal,
+        gradesPageEndpoint,
+        setGradesPageEndpoint,
+        csvUploadSuccess,
+        csvUploadErrorMessages,
+        resetCsvUpload,
+        markCsvUploadSuccess,
+        setCsvUploadErrors,
+    }), [
+        gradeFormat, showSuccess, showImportSuccessToast, activeView,
+        filterMenuOpen, filterMenuTransitioning,
+        toggleFilterMenu, closeFilterMenu, handleFilterMenuTransitionEnd,
+        modalState, setModalState, setModalStateFromTable, closeModal,
+        gradesPageEndpoint,
+        csvUploadSuccess, csvUploadErrorMessages,
+        resetCsvUpload, markCsvUploadSuccess, setCsvUploadErrors,
+    ]);
+    return (_jsx(GradebookUiContext.Provider, { value: value, children: children }));
+};
+/**
+ * useGradebookUi()
+ * Accessor for the gradebook UI-state context. Throws if used outside a
+ * <GradebookUiProvider>.
+ */
+export const useGradebookUi = () => {
+    const context = useContext(GradebookUiContext);
+    if (context === undefined) {
+        throw new Error('useGradebookUi must be used within a GradebookUiProvider');
+    }
+    return context;
+};
+export default GradebookUiContext;
+//# sourceMappingURL=gradebookUiContext.js.map

package/dist/data/gradebookUiContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradebookUiContext.js","sourceRoot":"","sources":["../../src/data/gradebookUiContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, {\n  createContext, useCallback, useContext, useEffect, useMemo, useRef, useState,\n} from 'react';\n\nimport { views, modalFieldKeys } from '@src/data/constants/app';\nimport { formatDateForDisplay } from '@src/data/formatUtils';\n\n/** Edit-grade modal state (was the Redux `app.modalState` slice). */\nexport interface ModalState {\n  open: boolean;\n  adjustedGradePossible: string | number;\n  adjustedGradeValue: string | number;\n  assignmentName: string;\n  reasonForChange: string;\n  todaysDate: string;\n  updateModuleId: string | null;\n  updateUserId: number | null;\n  updateUserName: string | null;\n}\n\n/** Payload for opening the modal from a grade-table cell. */\nexport interface ModalStateFromTablePayload {\n  subsection: {\n    attempted?: boolean;\n    score_possible?: number;\n    subsection_name?: string;\n    module_id?: string;\n  };\n  userEntry: {\n    user_id?: number;\n    username?: string;\n  };\n}\n\n// Mirrors the Redux `app` reducer's `initialState.modalState`.\nconst initialModalState: ModalState = {\n  open: false,\n  adjustedGradePossible: '',\n  adjustedGradeValue: 0,\n  assignmentName: '',\n  reasonForChange: '',\n  todaysDate: '',\n  updateModuleId: null,\n  updateUserId: null,\n  updateUserName: null,\n};\n\n/**\n * Client-side gradebook **UI** state, held in React (Context + useState).\n *\n * Replaces the non-filter UI bits of the old Redux `app` and `grades` slices:\n * grade format toggle, success banner, import toast, active view, filter-menu\n * open/transition, modal state, pagination cursor, and CSV-upload feedback.\n */\nexport interface GradebookUiContextValue {\n  /** Grade display format: 'percent' | 'absolute'. */\n  gradeFormat: string;\n  setGradeFormat: (value: string) => void;\n  /** Success banner shown after a grade override is saved. */\n  showSuccess: boolean;\n  setShowSuccess: (value: boolean) => void;\n  /** Toast shown after a successful bulk grade CSV import. */\n  showImportSuccessToast: boolean;\n  setShowImportSuccessToast: (value: boolean) => void;\n  /** Active top-level tab: views.grades | views.bulkManagementHistory. */\n  activeView: string;\n  setActiveView: (value: string) => void;\n  /**\n   * Filter sidebar open/close state, with the same two-phase transition the old\n   * Redux `app.filterMenu` slice modeled (`open` + `transitioning`). Consumers\n   * derive `isClosed`/`isOpening` from these two.\n   */\n  filterMenuOpen: boolean;\n  filterMenuTransitioning: boolean;\n  /** Toggle the sidebar (starts the transition, flips `open` on the next frame). */\n  toggleFilterMenu: () => void;\n  /** Close the sidebar if it is currently open (no-op otherwise). */\n  closeFilterMenu: () => void;\n  /** onTransitionEnd handler for the sidebar; ends the transition phase. */\n  handleFilterMenuTransitionEnd: (event: React.TransitionEvent) => void;\n  /** Edit-grade modal state (was Redux `app.modalState`). */\n  modalState: ModalState;\n  /** Merge a partial update into modalState (filtered to the known modal fields). */\n  setModalState: (partial: Partial<ModalState>) => void;\n  /** Open the modal seeded from a grade-table cell (subsection + user entry). */\n  setModalStateFromTable: (payload: ModalStateFromTablePayload) => void;\n  /** Reset the modal to its initial (closed) state. */\n  closeModal: () => void;\n  /**\n   * Current grades pagination cursor: the opaque prev/next URL from the last\n   * grades response, or null for the first (unpaged) page. Held here so the\n   * `useGrades` query can key/refetch off it; filter changes reset it to null.\n   */\n  gradesPageEndpoint: string | null;\n  setGradesPageEndpoint: (endpoint: string | null) => void;\n  /**\n   * Bulk grade CSV-upload result feedback shown by `BulkManagementAlerts` (was the\n   * Redux `grades.bulkManagement` `uploadSuccess`/`errorMessages`).\n   */\n  csvUploadSuccess: boolean;\n  csvUploadErrorMessages: string[];\n  /** Reset the CSV-upload feedback (upload started). */\n  resetCsvUpload: () => void;\n  /** Mark the CSV upload succeeded. */\n  markCsvUploadSuccess: () => void;\n  /** Record CSV-upload error messages. */\n  setCsvUploadErrors: (messages: string[]) => void;\n}\n\nconst GradebookUiContext = createContext<GradebookUiContextValue | undefined>(undefined);\n\ninterface GradebookUiProviderProps {\n  children: React.ReactNode;\n}\n\nexport const GradebookUiProvider = ({ children }: GradebookUiProviderProps) => {\n  const [gradeFormat, setGradeFormat] = useState<string>('percent');\n  const [showSuccess, setShowSuccess] = useState<boolean>(false);\n  const [showImportSuccessToast, setShowImportSuccessToast] = useState<boolean>(false);\n  const [activeView, setActiveView] = useState<string>(views.grades);\n\n  // Filter sidebar animation state. This mirrors the old Redux `filterMenu` thunks:\n  // `toggle` flips `open` one frame after starting the transition, and the sidebar's\n  // onTransitionEnd ends the transition. `close` reads the latest `open` via a ref\n  // so it can be a stable callback.\n  const [filterMenuOpen, setFilterMenuOpen] = useState<boolean>(false);\n  const [filterMenuTransitioning, setFilterMenuTransitioning] = useState<boolean>(false);\n  const filterMenuOpenRef = useRef<boolean>(filterMenuOpen);\n  useEffect(() => {\n    filterMenuOpenRef.current = filterMenuOpen;\n  }, [filterMenuOpen]);\n\n  const toggleFilterMenu = useCallback(() => {\n    setFilterMenuTransitioning(true);\n    window.requestAnimationFrame(() => {\n      window.setTimeout(() => {\n        setFilterMenuOpen((open) => !open);\n      });\n    });\n  }, []);\n\n  const closeFilterMenu = useCallback(() => {\n    if (filterMenuOpenRef.current) {\n      toggleFilterMenu();\n    }\n  }, [toggleFilterMenu]);\n\n  const handleFilterMenuTransitionEnd = useCallback((event: React.TransitionEvent) => {\n    if (event.currentTarget === event.target) {\n      setFilterMenuTransitioning(false);\n    }\n  }, []);\n\n  // Edit-grade modal state. These ops are a faithful port of the Redux `app`\n  // reducer cases: `setModalState` merges a field-filtered partial, `closeModal`\n  // resets to the initial state, and `setModalStateFromTable` opens the modal\n  // seeded from the clicked grade cell.\n  const [modalState, setModalStateValue] = useState<ModalState>(initialModalState);\n\n  const setModalState = useCallback((partial: Partial<ModalState>) => {\n    const filtered = (Object.keys(modalFieldKeys) as (keyof ModalState)[]).reduce(\n      (obj, key) => (partial[key] !== undefined ? { ...obj, [key]: partial[key] } : obj),\n      {} as Partial<ModalState>,\n    );\n    setModalStateValue((prev) => ({ ...prev, ...filtered }));\n  }, []);\n\n  const setModalStateFromTable = useCallback(\n    ({ subsection, userEntry }: ModalStateFromTablePayload) => {\n      setModalStateValue({\n        open: true,\n        adjustedGradeValue: '',\n        reasonForChange: '',\n        todaysDate: formatDateForDisplay(new Date()),\n        adjustedGradePossible: subsection.attempted ? (subsection.score_possible ?? '') : '',\n        assignmentName: `${subsection.subsection_name}`,\n        updateModuleId: subsection.module_id ?? null,\n        updateUserId: userEntry.user_id ?? null,\n        updateUserName: userEntry.username ?? null,\n      });\n    },\n    [],\n  );\n\n  const closeModal = useCallback(() => {\n    setModalStateValue(initialModalState);\n  }, []);\n\n  // Grades pagination cursor (opaque prev/next URL, or null for the first page).\n  const [gradesPageEndpoint, setGradesPageEndpoint] = useState<string | null>(null);\n\n  // Bulk CSV-upload result feedback (was Redux `grades.bulkManagement`).\n  const [csvUploadSuccess, setCsvUploadSuccess] = useState<boolean>(false);\n  const [csvUploadErrorMessages, setCsvUploadErrorMessages] = useState<string[]>([]);\n  const resetCsvUpload = useCallback(() => {\n    setCsvUploadSuccess(false);\n    setCsvUploadErrorMessages([]);\n  }, []);\n  const markCsvUploadSuccess = useCallback(() => {\n    setCsvUploadSuccess(true);\n    setCsvUploadErrorMessages([]);\n  }, []);\n  const setCsvUploadErrors = useCallback((messages: string[]) => {\n    setCsvUploadSuccess(false);\n    setCsvUploadErrorMessages(messages);\n  }, []);\n\n  const value = useMemo<GradebookUiContextValue>(\n    () => ({\n      gradeFormat,\n      setGradeFormat,\n      showSuccess,\n      setShowSuccess,\n      showImportSuccessToast,\n      setShowImportSuccessToast,\n      activeView,\n      setActiveView,\n      filterMenuOpen,\n      filterMenuTransitioning,\n      toggleFilterMenu,\n      closeFilterMenu,\n      handleFilterMenuTransitionEnd,\n      modalState,\n      setModalState,\n      setModalStateFromTable,\n      closeModal,\n      gradesPageEndpoint,\n      setGradesPageEndpoint,\n      csvUploadSuccess,\n      csvUploadErrorMessages,\n      resetCsvUpload,\n      markCsvUploadSuccess,\n      setCsvUploadErrors,\n    }),\n    [\n      gradeFormat, showSuccess, showImportSuccessToast, activeView,\n      filterMenuOpen, filterMenuTransitioning,\n      toggleFilterMenu, closeFilterMenu, handleFilterMenuTransitionEnd,\n      modalState, setModalState, setModalStateFromTable, closeModal,\n      gradesPageEndpoint,\n      csvUploadSuccess, csvUploadErrorMessages,\n      resetCsvUpload, markCsvUploadSuccess, setCsvUploadErrors,\n    ],\n  );\n\n  return (\n    <GradebookUiContext.Provider value={value}>\n      {children}\n    </GradebookUiContext.Provider>\n  );\n};\n\n/**\n * useGradebookUi()\n * Accessor for the gradebook UI-state context. Throws if used outside a\n * <GradebookUiProvider>.\n */\nexport const useGradebookUi = (): GradebookUiContextValue => {\n  const context = useContext(GradebookUiContext);\n  if (context === undefined) {\n    throw new Error('useGradebookUi must be used within a GradebookUiProvider');\n  }\n  return context;\n};\n\nexport default GradebookUiContext;\n"]}

package/dist/data/queryClient.d.ts

@@ -0,0 +1,10 @@
+import { QueryClient } from '@tanstack/react-query';
+/**
+ * Application-wide React Query client.
+ *
+ * Defaults are promoted here (rather than repeated per hook) to keep individual
+ * query hooks lean: cache server data for 5 minutes and skip retries on 4xx.
+ */
+export declare const makeQueryClient: () => QueryClient;
+declare const queryClient: QueryClient;
+export default queryClient;