@propriety/court-calendar 1.0.196 → 1.0.198

package/README.md

@@ -454,7 +454,7 @@ All data is fetched from `https://utils.aventine.ai`. Every request requires the
 | `/court-dates/{id}` | DELETE | Delete a court date |
 | `/court-dates/{id}/cases` | GET | Fetch cases for a court date |
 | `/court-cases/search?term=...&page=...` | GET | Search cases (paginated) |
-| `/court-cases/by-court-dates` | POST | Cases for up to 1000 court dates, `{"ids": [...]}` → `{"cases": {id: [...]}}` |
+| `/court-cases/by-court-dates` | POST | Cases for up to 1000 court dates, `{"ids": [...]}` → `{"cases": {id: [...]}}`, with only the Courtfiles columns the calendar reads |
 | `/court-cases/snooze/upload/{id}` | GET | Snooze upload deadline by 1 business day |
 | `/users/all` | GET | Fetch all users |
 | `/users/hearing-officers` | GET | Fetch hearing officers |

package/dist/_components/LoadingBar.d.ts

@@ -1,8 +1,13 @@
 interface LoadingBarProps {
     isFetchingDates: boolean;
     isFetchingCases: boolean;
+    caseLoad?: {
+        requested: number;
+        settled: number;
+        failed: number;
+    };
     isSearching?: boolean;
     isFiltering?: boolean;
 }
-export default function LoadingBar({ isFetchingDates, isFetchingCases, isSearching, isFiltering, }: LoadingBarProps): import("react/jsx-runtime").JSX.Element | null;
+export default function LoadingBar({ isFetchingDates, isFetchingCases, caseLoad, isSearching, isFiltering, }: LoadingBarProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/_components/Modal/DateDetails/HearingOfficerPrompt.d.ts

@@ -0,0 +1,7 @@
+import { CourtDate } from '../../../types';
+/** Asks who hears the session Adjourn moved cases onto, when that session has no hearing officer. */
+export default function HearingOfficerPrompt({ session, onAssign, onClose, }: {
+    session: CourtDate;
+    onAssign: (session: CourtDate, officerId: number) => Promise<boolean>;
+    onClose: () => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/_components/Toolbar/CalendarNav.d.ts

@@ -1,5 +1,5 @@
 import { Calendar } from '@fullcalendar/core/index.js';
-export default function CalendarNav({ calendarApi, handleCreateClick, onPrint, onRefresh, currentView, setCurrentView, currentDate, setCurrentDate, isFetchingDates, isFetchingCases, lastFetchedAt, canEdit, }: {
+declare const _default: import('react').NamedExoticComponent<{
     calendarApi: Calendar | null;
     handleCreateClick: () => void;
     onPrint: () => void;
@@ -12,4 +12,5 @@ export default function CalendarNav({ calendarApi, handleCreateClick, onPrint, o
     isFetchingCases: boolean;
     lastFetchedAt: Date | null;
     canEdit: boolean;
-}): import("react/jsx-runtime").JSX.Element;
+}>;
+export default _default;

package/dist/_components/Toolbar/Toolbar.d.ts

@@ -1,3 +1,4 @@
-export default function Toolbar({ activeUser }: {
+declare const _default: import('react').NamedExoticComponent<{
     activeUser: number | null;
-}): import("react/jsx-runtime").JSX.Element;
+}>;
+export default _default;

package/dist/helpers/CalEvent.d.ts

@@ -43,4 +43,8 @@ export declare function dateToKey(d: Date): string;
  * "2025-04-15" and "2025-04-15T00:00:00Z" would both land on April 15 locally.
  */
 export declare function parseLocalDate(s: string): Date;
+/** The day a date or marker value is drawn on: a Date as given, an API string on its local day. */
+export declare function markerDay(value: Date | string | null | undefined): Date | null;
+/** Whether `value` is drawn in [start, end). */
+export declare function dayIn(value: Date | string | null | undefined, start: Date, end: Date): boolean;
 export declare function buildCalEvents(courtDates: CourtDate[], casesByCourtDateId: Record<string, Case[]>): CalEvent[];

package/dist/hooks/UseCaseData.d.ts

@@ -1,34 +1,51 @@
 import { Case, CourtDate } from '../types';
+/** The range the calendar shows. A bulk load requests the dates drawn in it first. */
+export interface VisibleRange {
+    start: Date;
+    end: Date;
+}
 /**
  * Manages fetching and in-memory storage of cases for court dates.
  *
  * Each court date is served from memory if React state already holds its cases, otherwise from the
- * API: per date for up to BULK_THRESHOLD SCAR dates, one bulk by-ids request above that. The open
- * date always loads per date, because the bulk case is thinner than its modal reads. There is no
- * browser cache: a reload starts from an empty memory, so every reload reaches the API.
+ * API: per date for up to BULK_THRESHOLD SCAR dates, by-ids bulk requests above that (the dates drawn in
+ * the visible range first, then the rest). The open date always loads per date, because the bulk case is
+ * thinner than its modal reads. There is no browser cache: a reload starts from an empty memory, so every
+ * reload reaches the API.
  *
  * @param apiKey             API key forwarded to case fetch helpers.
  * @param courtDates         The court dates to load cases for.
  * @param selectedCourtDate  The currently-selected court date; its cases are always force-refreshed
  *                           from the API (bypassing memory) when the selection changes.
+ * @param visibleRangeRef    The calendar's visible range, read when a bulk load starts.
  *
  * @returns
  * - `allCases`               – Map of `caseKey → Case[]` for all loaded court dates.
  * - `selectedCases`          – Cases belonging to `selectedCourtDate`.
  * - `isFetchingCases`        – `true` while any non-silent fetch is in flight.
+ * - `caseLoad`               – Dates requested, settled and failed by the latest non-silent load. Kept after it
+ *                              ends, so the loading bar can tell a finished load from a failed one.
  * - `forceRefreshCases`      – Re-fetches every court date from the API (manual refresh).
  * - `updateCases`            – Optimistically merges a partial cases map into state.
  * - `refreshCases`           – Silently reconciles one court date with the server after a mutation.
  * - `deleteCasesFromMemory`  – Removes all cases for a given court date from memory.
  */
-export declare function useCaseData({ apiKey, courtDates, selectedCourtDate, }: {
+export declare function useCaseData({ apiKey, courtDates, selectedCourtDate, visibleRangeRef, }: {
     apiKey: string;
     courtDates: CourtDate[];
     selectedCourtDate: CourtDate | null;
+    visibleRangeRef?: {
+        readonly current: VisibleRange | null;
+    };
 }): {
     allCases: Record<string, Case[]>;
     selectedCases: Case[];
     isFetchingCases: boolean;
+    caseLoad: {
+        requested: number;
+        settled: number;
+        failed: number;
+    };
     forceRefreshCases: () => void;
     updateCases: (cases: Record<string, Case[]>) => void;
     refreshCases: (courtDate: CourtDate) => Promise<void>;

package/dist/hooks/UseModalActions.d.ts

@@ -22,6 +22,8 @@ import { AdjournResult } from '../helpers/api/cases';
  *                                        false and leaves local state untouched if the server refused.
  * - `handleViewUpdateChair`             – Optimistically updates a first/second chair in view mode.
  * - `handleSelectedCasesAdjournmentChange` – Adjourns a set of cases (sets AdjournedDate + `OA` determination), then reconciles with the server.
+ *                                        `needsJudge` is the session they moved to when it has no hearing officer.
+ * - `handleAssignHearingOfficer`        – Sets the hearing officer on that session, in memory once the server has it.
  * - `handleSelectedCasesClearDetermination` – Clears the determination for a set of cases (backend only clears `D`), then reconciles with the server.
  */
 export declare function useModalActions({ modalMode, selectedCourtDate, selectedCases, editedData, editedCases, setEditedData, setIsOpen, pendingNoticeFiles, onUploadDeadlineNotice, }: {
@@ -40,6 +42,9 @@ export declare function useModalActions({ modalMode, selectedCourtDate, selected
     handleDelete: () => Promise<boolean>;
     handleViewUpdateChair: (position: "first" | "second", userId: number | null) => void;
     handleToggleComplete: (complete: boolean) => void;
-    handleSelectedCasesAdjournmentChange: (casesToUpdate: Case[], date: Date | null) => Promise<AdjournResult>;
+    handleSelectedCasesAdjournmentChange: (casesToUpdate: Case[], date: Date | null) => Promise<AdjournResult & {
+        needsJudge?: CourtDate;
+    }>;
+    handleAssignHearingOfficer: (session: CourtDate, officerId: number) => Promise<boolean>;
     handleSelectedCasesClearDetermination: (casesToUpdate: Case[]) => Promise<boolean>;
 };