@propriety/court-calendar 1.0.103 → 1.0.105

package/README.md

@@ -8,7 +8,7 @@ A React component library for managing court dates, cases, and evidence. Built w
 npm install @propriety/court-calendar
 ```
 
-You must also have the following peer dependencies installed:
+Peer dependencies:
 
 ```bash
 npm install react react-dom @mui/material @mui/icons-material @mui/x-data-grid @mui/x-date-pickers @emotion/react @emotion/styled
@@ -25,14 +25,7 @@ function App() {
 }
 ```
 
-### Props
-
-| Prop | Type | Description |
-|------|------|-------------|
-| `apiKey` | `string` | API key for authenticating with the Aventine API |
-| `activeUser` | `number` | The current user's ID (used for chair assignments and edit tracking) |
-
-### CSS Import
+### CSS import
 
 You **must** import the stylesheet separately:
 
@@ -40,110 +33,166 @@ You **must** import the stylesheet separately:
 import '@propriety/court-calendar/styles.css';
 ```
 
-### Theming
-
-The component supports light and dark themes via the `data-theme` attribute on the document body:
-
-```tsx
-document.body.setAttribute('data-theme', 'dark'); // or 'light'
-```
+### Props
 
-Components use the `.themed` CSS class to pick up theme variables.
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `apiKey` | `string` | required | API key for authenticating with the Aventine API |
+| `activeUser` | `number` | required | The current user's ID (used for chair assignments and edit tracking) |
+| `showLegend` | `boolean` | `true` | Whether to render the hearing-type legend below the calendar |
+| `mode` | `'light' \| 'dark'` | `'light'` | Color scheme |
+| `themeOverrides` | `ThemeOptions` | — | MUI theme overrides applied on top of the default theme |
+| `routeParams` | `CalendarRouteParams` | — | Current URL state, parsed and passed in by the host app's router. See [URL routing](#url-routing--deep-linking). |
+| `onRouteChange` | `(params: CalendarRouteParams) => void` | — | Called whenever navigable state changes. The host app should write these params to the URL. See [URL routing](#url-routing--deep-linking). |
 
 ---
 
-## Development
+## URL routing / deep linking
 
-### Prerequisites
+By default the calendar is stateless from a URL perspective — navigating to a court date or applying a filter leaves no trace in the browser address bar. The `routeParams` / `onRouteChange` props opt into URL sync without coupling the library to any specific router.
 
-- Node.js 20+
-- npm
+### How it works
 
-### Setup
+The library never reads or writes `window.location` directly when `onRouteChange` is provided. Instead:
 
-```bash
-git clone git@github.com:Aventine-Git/court-calendar.git
-cd court-calendar
-npm install
-```
+- **Outbound:** whenever navigable state changes (view, date, open modal, active filters), `onRouteChange` is called with a `CalendarRouteParams` object describing the full current state.
+- **Inbound:** on mount, the library reads `routeParams` once and restores the saved state — including re-opening a court date modal or drilling straight into a case.
 
-### Dev Server
+The host app owns the URL. It parses params out of its router, passes them as `routeParams`, and writes new params back in `onRouteChange`. Two utility functions handle the encoding:
 
-```bash
-npm run dev
+```ts
+import {
+    CCalendar,
+    parseCalendarSearchParams,
+    serializeCalendarParams,
+} from '@propriety/court-calendar';
 ```
 
-This starts the Vite dev server using the `dev/` directory as the entry point (`dev/App.tsx` and `dev/main.tsx`). The dev app wraps the `CCalendar` component for local testing.
+### Integration examples
 
-**Important:** The API only accepts requests from `localhost:8000`. The dev server must run on port 8000 or API calls will be rejected with CORS errors.
+**React Router v6**
 
-### Environment Variables
+```tsx
+import { useSearchParams } from 'react-router-dom';
+import { CCalendar, parseCalendarSearchParams, serializeCalendarParams } from '@propriety/court-calendar';
+
+function CalendarPage() {
+    const [searchParams, setSearchParams] = useSearchParams();
+
+    return (
+        <CCalendar
+            apiKey={API_KEY}
+            activeUser={userId}
+            routeParams={parseCalendarSearchParams(searchParams)}
+            onRouteChange={(params) =>
+                setSearchParams(serializeCalendarParams(params), { replace: true })
+            }
+        />
+    );
+}
+```
 
-Create a `.env` file in the project root:
+**TanStack Router**
 
-```
-VITE_CALENDAR_API_KEY=your-api-key-here
+```tsx
+import { useSearch, useNavigate } from '@tanstack/react-router';
+import { CCalendar, parseCalendarSearchParams, serializeCalendarParams } from '@propriety/court-calendar';
+
+function CalendarPage() {
+    const search = useSearch({ from: '/calendar' });
+    const navigate = useNavigate();
+
+    return (
+        <CCalendar
+            apiKey={API_KEY}
+            activeUser={userId}
+            routeParams={parseCalendarSearchParams(search as Record<string, string>)}
+            onRouteChange={(params) =>
+                navigate({ search: Object.fromEntries(serializeCalendarParams(params)), replace: true })
+            }
+        />
+    );
+}
 ```
 
-This key is used by the dev app and is accessed via `import.meta.env.VITE_CALENDAR_API_KEY`.
+**Next.js App Router**
 
-### Build
-
-```bash
-npm run build
+```tsx
+'use client';
+import { useRouter, useSearchParams, usePathname } from 'next/navigation';
+import { CCalendar, parseCalendarSearchParams, serializeCalendarParams } from '@propriety/court-calendar';
+
+export default function CalendarPage() {
+    const router = useRouter();
+    const pathname = usePathname();
+    const searchParams = useSearchParams();
+
+    return (
+        <CCalendar
+            apiKey={API_KEY}
+            activeUser={userId}
+            routeParams={parseCalendarSearchParams(searchParams)}
+            onRouteChange={(params) => {
+                const qs = serializeCalendarParams(params).toString();
+                router.replace(qs ? `${pathname}?${qs}` : pathname);
+            }}
+        />
+    );
+}
 ```
 
-Runs TypeScript compilation (`tsc -b`) followed by the Vite library build. Output goes to `dist/`:
+### Standalone mode (no router)
 
-- `dist/index.mjs` - ES module bundle
-- `dist/index.d.ts` - TypeScript type definitions
-- `dist/court-calendar.css` - Compiled styles
+When neither `routeParams` nor `onRouteChange` is provided, the library manages the URL itself using `window.history.replaceState`. This is suitable for single-page apps without a router or for standalone embedding. The URL updates in place without adding history entries.
 
-The build externalizes React, React-DOM, MUI, and Emotion packages (they are peer dependencies and not bundled).
+### URL parameter reference
 
-### Lint
+Parameters use short keys to keep the address bar readable. Only non-default values appear in the URL — a fully default calendar state produces a clean URL with no search params.
 
-```bash
-npm run lint
-```
-
-Uses ESLint with TypeScript plugin. Biome is also configured for formatting (4-space indent, 120 char line width, single quotes).
+| URL key | `CalendarRouteParams` field | Default (omitted when) | Notes |
+|---------|----------------------------|------------------------|-------|
+| `view` | `view` | `'dayGridMonth'` | One of `dayGridMonth`, `timeGridWeek`, `timeGridDay`, `listDay`, `tableView` |
+| `date` | `date` | today | ISO `YYYY-MM-DD` |
+| `cdId` | `courtDateId` | absent | Integer court date ID — opens the details modal on load |
+| `ci` | `caseIdx` | absent | `Case.SCARIndexNumber` — opens a specific case (requires `cdId`) |
+| `ht` | `showVirtual` / `showInPerson` / `showUnknown` | all visible | Comma-separated list of **hidden** hearing types, e.g. `ht=virtual,inPerson` |
+| `user` | `showOnlyAssignedToUser` | `null` | UserID integer, or `-1` for "Unassigned" |
+| `dl` | `showUploadDeadlines` | `false` | `dl=1` when true |
+| `adj` | `showAdjournmentDates` | `true` | `adj=0` when false |
+| `dt` | `dateTypeFilter` | `'all'` | `scar` or `negotiations` |
+| `muni` | `municode` | `null` | Municipality code string |
+| `settled` | `showOnlyUnsettled` | `true` | `settled=1` when the filter is **off** (inverted because default is on) |
+| `noEvid` | `showOnlyWithoutEvidence` | `false` | `noEvid=1` when true |
+| `unrev` | `showOnlyUnreviewed` | `false` | `unrev=1` when true |
+| `q` | `searchTerm` | `''` | Free-text search |
 
----
-
-## Testing
+Example URL after opening a case with a filter applied:
 
-There are currently no automated tests. Testing is done manually through the dev server.
+```
+/calendar?cdId=1234&ci=2024-98765&view=listDay&date=2025-06-15&dt=scar
+```
 
----
+### What is and isn't bookmarkable
 
-## API
+The URL captures:
+- Current calendar view and visible date
+- Which court date modal is open (`cdId`)
+- Which case is open within that modal (`ci`)
+- All active filter state
 
-All data is fetched from `https://utils.aventine.ai`. Every request requires the `x-api-key` header.
+The URL does **not** capture:
+- Edit mode or Create mode (transient form state — these are suppressed from `onRouteChange`)
 
-### Endpoints
+### Bootstrap sequence
 
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/court-dates/all` | GET | Fetch all court dates |
-| `/court-dates/create` | POST | Create a new court date |
-| `/court-dates/{id}/update` | PUT | Update a court date |
-| `/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/filtering?page=...&page_size=...` | GET | List all cases (paginated) |
-| `/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 |
-| `/utils/get-muni-names` | GET | Fetch municipality names |
+When the page loads with params in the URL, the library restores state in phases to handle async data loading:
 
-### Limitations
+1. **Phase 1 (synchronous, on mount):** View, date, and filter state are applied immediately from `routeParams`.
+2. **Phase 1b:** If `user=N` is in the URL, the User object is looked up from the reference data once it loads and merged into filter context. `user=-1` (Unassigned) is handled as a special case — no lookup is needed.
+3. **Phase 2:** Once court date data finishes loading, the target court date is found and its details modal opened. If the court date has been filtered out of view (e.g. all its cases are settled and the unsettled filter is on), a minimal stub is built from the raw court date data so the modal still opens correctly.
+4. **Phase 3:** Once cases for the opened court date finish loading, the target case is found and opened. This works even for settled cases that are hidden from the calendar view — `selectedCases` always contains all cases regardless of active filters.
 
-- **Port restriction:** The API only accepts requests from `localhost:8000`. Running the dev server on any other port will result in CORS failures.
-- **No offline support:** All CRUD operations require an active connection to the API. The IndexedDB cache is read-only (used for faster page loads, not offline editing).
-- **Cache expiry:** Court dates cache expires after 5 minutes, cases cache after 1 hour. After expiry, data is re-fetched from the API on the next page load.
-- **No pagination for court dates:** `getAllDates` fetches every court date in a single request. For large datasets this could be slow.
-- **Municipality and user data loads on import:** `munis.ts` and `people.ts` fire fetch requests at module load time, not lazily.
+If a `cdId` or `ci` value in the URL doesn't match any loaded data, a brief error snackbar is shown.
 
 ---
 
@@ -161,38 +210,87 @@ All data is fetched from `https://utils.aventine.ai`. Every request requires the
 | `CaseViewer` | DataGrid listing cases for a selected court date. |
 | `CaseDetails` | Read-only view of a single case with evidence and SCAR data. |
 
+### Hooks
+
+| Hook | Description |
+|------|-------------|
+| `useCourtDates` | Fetches and caches court dates and negotiations. Handles polling and optimistic in-memory updates. |
+| `useCaseData` | Fetches and caches cases for all court dates. Maintains a `Record<caseKey, Case[]>` memory store. |
+| `useCalendarEvents` | Derives FullCalendar event objects and `CalEvent` buckets from court date + case data. Applies filter context. |
+| `useModalSelection` | Tracks which court date event is selected and manages `openDetailsModal` / `openCreateModal`. |
+| `useModalState` | Manages form state for Edit/Create modes and `clickedCase` for Case Details mode. |
+| `useModalActions` | Handles save, delete, and chair-update API calls. |
+| `useRouteSync` | Syncs navigable state to/from the URL. See [URL routing](#url-routing--deep-linking). |
+| `useScrollbarClickDetection` | Prevents date-click from firing when the user clicks a scrollbar. |
+
 ### Helpers
 
 | Helper | Description |
 |--------|-------------|
-| `courtDates.ts` | CRUD operations for court dates. Sends datetime strings combining date + hearing time. |
-| `cases.ts` | Case fetching (by court date, paginated, search). Settlement and evidence checks. |
-| `cache.ts` | Dexie-based IndexedDB caching with TTL (5 min for dates, 1 hour for cases). |
-| `formatter.ts` | Date formatting for API (`YYYY-MM-DD` or `YYYY-MM-DD HH:mm:00`). 12h/24h time conversion. Evidence string formatting. |
-| `munis.ts` | Municipality name lookups. Fetches data once on module load. |
-| `people.ts` | User and hearing officer lookups. Fetches data once on module load. |
+| `helpers/routing.ts` | `parseCalendarSearchParams`, `serializeCalendarParams`, `buildCalendarRouteParams`, `extractFilterFields`. Pure functions for URL encoding/decoding. |
+| `helpers/CalEvent.ts` | `buildCalEvents` — derives main, extra-day, and adjournment `CalEvent` buckets from court date + case data. |
+| `helpers/cases.ts` | Case fetching (by court date, paginated, search). Settlement and evidence checks. |
+| `helpers/courtDates.ts` | `caseKey` (memory-map key), `isVillageDate` (municipality code check). |
+| `helpers/documentActions.ts` | Open, download, and print document helpers (used by DocCard). |
+| `helpers/formatter.ts` | Date formatting for API (`YYYY-MM-DD` or `YYYY-MM-DD HH:mm:00`). Evidence string formatting. |
+| `helpers/cache.ts` | Dexie-based IndexedDB caching with TTL. |
+| `helpers/api/` | Fetch wrappers for each API endpoint group (court dates, cases, munis, people). |
+
+### CalEvent
 
-### Key Types
+`CalEvent` is the internal representation of a single calendar entry. One `CourtDate` can produce multiple `CalEvent` objects:
+
+| Type | `isAdjourned` | `isExtraDay` | Description |
+|------|---------------|--------------|-------------|
+| Main | `false` | `false` | The primary entry on the original court date. Holds all non-adjourned cases. |
+| Extra-day | `false` | `true` | Additional days from `CourtDate.MultipleDates`. Same cases as the main event. |
+| Adjournment | `true` | `false` | One entry per unique adjourned date, holding the cases adjourned to that date. |
+
+URL routing always targets the main `CalEvent` when restoring a modal — adjournment and extra-day entries are never used as the bootstrap target.
+
+### Key types
 
 ```typescript
+interface CalendarRouteParams {
+    view?: 'dayGridMonth' | 'timeGridWeek' | 'timeGridDay' | 'listDay' | 'tableView';
+    date?: string;                        // ISO: "YYYY-MM-DD"
+    courtDateId?: number;
+    caseIdx?: string;                     // Case.SCARIndexNumber
+    showVirtual?: boolean;
+    showInPerson?: boolean;
+    showUnknown?: boolean;
+    showOnlyAssignedToUser?: number | null;
+    showUploadDeadlines?: boolean;
+    showAdjournmentDates?: boolean;
+    dateTypeFilter?: 'all' | 'scar' | 'negotiations';
+    municode?: string | null;
+    showOnlyUnsettled?: boolean;
+    showOnlyWithoutEvidence?: boolean;
+    showOnlyUnreviewed?: boolean;
+    searchTerm?: string;
+}
+
 interface CourtDate {
     CourtDateID: number;
     CourtDate: Date;
     MuniCode: string;
     UploadDeadline: Date | null;
     CourtCases: number;
-    Lifecycle: Lifecycle | null;    // Scheduled | Assigned | Uploaded | Adjourned
+    Lifecycle: 'Scheduled' | 'Assigned' | 'Uploaded' | 'Adjourned' | null;
+    DateType: '' | 'Negotiations' | null;  // '' = SCAR
     HearingTime: string;
     HearingLink: string | null;
-    Source: SourceType | null;      // manual | email | etrack
-    Type: HearingType | null;       // Other | Virtual | InPerson
+    Source: 'manual' | 'email' | 'etrack' | null;
+    Type: 'Other' | 'Virtual' | 'InPerson' | null;
     FirstChair: number | null;
     SecondChair: number | null;
     HearingOfficer: number | null;
-    IsAdjourned: boolean;
-    AdjournmentDate: Date | null;
-    Notes: string | null;
+    Notes: Notes[] | null;
     NoticeFile: string | null;
+    MultipleDates: Date[] | null;
+    Address: string | null;
+    Room: string | null;
+    SkipMotion: boolean | null;
 }
 
 interface Case {
@@ -202,18 +300,112 @@ interface Case {
     SCARDeterminationAction: string;
     property_data: { Address: string; PropertyOwnerFull: string };
     evidence: Evidence | null;
-    DateCompleted: Date | null;
-    // ... plus Village SCAR fields
+    AdjournedDate: Date | null;
+    // ... plus Village SCAR fields and negotiation/stip tracking
 }
 ```
 
 ---
 
+## Development
+
+### Prerequisites
+
+- Node.js 20+
+- npm
+
+### Setup
+
+```bash
+git clone git@github.com:Aventine-Git/court-calendar.git
+cd court-calendar
+npm install
+```
+
+### Dev server
+
+```bash
+npm run dev
+```
+
+Starts the Vite dev server using `dev/App.tsx` as the entry point. **The API only accepts requests from `localhost:8000`** — the dev server must run on port 8000 or API calls will fail with CORS errors.
+
+### Environment variables
+
+Create a `.env` file in the project root:
+
+```
+VITE_CALENDAR_API_KEY=your-api-key-here
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+Runs `tsc -b` then the Vite library build. Output in `dist/`:
+
+- `dist/index.mjs` — ES module bundle
+- `dist/index.d.ts` — TypeScript declarations
+- `dist/court-calendar.css` — compiled styles
+
+React, React-DOM, MUI, and Emotion are externalized (peer dependencies, not bundled).
+
+### Lint
+
+```bash
+npm run lint
+```
+
+ESLint with TypeScript plugin. Biome is configured for formatting (4-space indent, 120-char line width, single quotes).
+
+---
+
+## Testing
+
+```bash
+npm run test
+```
+
+Vitest + `@testing-library/react` + jsdom. Test files live in `src/__tests__/` mirroring the source tree:
+
+| Test file | Covers |
+|-----------|--------|
+| `helpers/CalEvent.test.ts` | `buildCalEvents`, `parseLocalDate` |
+| `helpers/routing.test.ts` | `serializeCalendarParams`, `parseCalendarSearchParams`, `buildCalendarRouteParams`, `extractFilterFields` |
+| `hooks/UseModalState.test.ts` | `useModalState` — edit/create init, modal close effects, clickedCase transitions |
+| `hooks/UseRouteSync.test.ts` | `useRouteSync` — outbound sync, replaceState fallback, bootstrap Phases 1–3, bootstrap errors |
+
+---
+
+## API
+
+All data is fetched from `https://utils.aventine.ai`. Every request requires the `x-api-key` header.
+
+### Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/court-dates/all` | GET | Fetch all court dates |
+| `/court-dates/create` | POST | Create a new court date |
+| `/court-dates/{id}/update` | PUT | Update a court date |
+| `/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/filtering?page=...&page_size=...` | GET | List all cases (paginated) |
+| `/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 |
+| `/utils/get-muni-names` | GET | Fetch municipality names |
+
+---
+
 ## CI/CD
 
 Publishing is automated via GitHub Actions (`.github/workflows/publish.yml`).
 
-**Trigger:** Every merged PR to `main`.
+**Trigger:** every merged PR to `main`.
 
 **Steps:**
 1. Checkout code
@@ -223,15 +415,14 @@ Publishing is automated via GitHub Actions (`.github/workflows/publish.yml`).
 5. Publish to npm with provenance
 
 **Required secrets:**
-- `NPM_TOKEN` - npm access token with publish permissions for the `@propriety` scope
+- `NPM_TOKEN` — npm access token with publish rights for the `@propriety` scope
 
 ---
 
-## Known Limitations
+## Known limitations
 
-- **Port 8000 only:** The backend API enforces CORS restrictions that only allow requests from `localhost:8000`. This applies to the dev server and any consuming application running locally.
-- **No test suite:** The project has no automated tests.
-- **Module-level side effects:** Municipality names and user data are fetched automatically when their modules are imported, which means network requests happen at import time rather than on demand.
-- **Cache is not invalidated on external changes:** If another user modifies a court date, the change won't appear until the local cache expires (5 minutes for dates, 1 hour for cases).
-- **Single API key:** The component expects a single API key passed as a prop. There is no built-in token refresh or rotation mechanism.
-- **No error UI:** API failures are logged to console but there are no user-facing error notifications (marked with TODO comments in the codebase).
+- **Port 8000 only:** The backend API enforces CORS that only allows requests from `localhost:8000`. Applies to the dev server and any locally running consumer.
+- **Cache is not invalidated on external changes:** If another user modifies a court date, the change won't appear until the local cache expires (1 minute for dates, 2 minutes for cases).
+- **No pagination for court dates:** `getAllDates` fetches every court date in a single request.
+- **Single API key:** No built-in token refresh or rotation.
+- **No error UI for API failures:** Network errors are logged to the console but not surfaced to the user (except for bootstrap errors, which show a brief snackbar).

package/dist/__tests__/helpers/routing.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/hooks/UseRouteSync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/_components/CCalendar.d.ts

@@ -1,7 +1,10 @@
-export default function CCalendar({ apiKey, activeUser, showLegend, mode, themeOverrides, }: {
+import { CalendarRouteParams } from '../types';
+export default function CCalendar({ apiKey, activeUser, showLegend, mode, themeOverrides, routeParams, onRouteChange, }: {
     apiKey: string;
     activeUser: number;
     showLegend?: boolean;
     mode?: 'light' | 'dark';
     themeOverrides?: import('@mui/material/styles').ThemeOptions;
+    routeParams?: CalendarRouteParams;
+    onRouteChange?: (params: CalendarRouteParams) => void;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -1,7 +1,7 @@
 import { Case, CourtDate } from '../../types';
 import { CalEvent } from '../../helpers/CalEvent';
 import { ModalMode } from './types';
-export default function CCModal({ modalIsOpen, modalMode, setModalMode, setIsOpen, selectedCourtDate, selectedDate, selectedCalEvent, selectedCases, isFetchingCases, }: {
+export default function CCModal({ modalIsOpen, modalMode, setModalMode, setIsOpen, selectedCourtDate, selectedDate, selectedCalEvent, selectedCases, isFetchingCases, editedData, setEditedData, editedCases, setEditedCases, clickedCase, setClickedCase, }: {
     modalIsOpen: boolean;
     modalMode: ModalMode;
     setModalMode: (mode: ModalMode) => void;
@@ -11,4 +11,10 @@ export default function CCModal({ modalIsOpen, modalMode, setModalMode, setIsOpe
     selectedCalEvent: CalEvent | null;
     selectedCases: Case[];
     isFetchingCases: boolean;
+    editedData: CourtDate | undefined;
+    setEditedData: (data: CourtDate) => void;
+    editedCases: Case[];
+    setEditedCases: (cases: Case[]) => void;
+    clickedCase: Case | null;
+    setClickedCase: (c: Case | null) => void;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/helpers/api/cases.d.ts

@@ -6,6 +6,7 @@ export declare function adjournCases(cases: {
     indexNumber: string;
     year: number;
 }[], adjournedDate: Date | null, apiKey: string, editUser?: number): Promise<boolean>;
+export declare function fetchFoilClerkEmails(parcelIds: string[], year: number, apiKey: string): Promise<string[]>;
 export interface FoilAffidavitResult {
     affidavit_key: string;
     sent: string[];

package/dist/helpers/routing.d.ts

@@ -0,0 +1,7 @@
+import { CalendarFilterCtx, CalendarRouteParams } from '../types';
+import { DEFAULT_FILTER_CTX } from '../constants';
+export declare function serializeCalendarParams(params: CalendarRouteParams): URLSearchParams;
+export declare function parseCalendarSearchParams(params: URLSearchParams | Record<string, string | undefined>): CalendarRouteParams;
+export declare function buildCalendarRouteParams(view: string, date: Date, courtDateId: number | null, caseIdx: string | null, filterCtx: CalendarFilterCtx): CalendarRouteParams;
+export declare function extractFilterFields(params: CalendarRouteParams): Partial<CalendarFilterCtx>;
+export { DEFAULT_FILTER_CTX };

package/dist/hooks/UseRouteSync.d.ts

@@ -0,0 +1,31 @@
+import { Case, CalendarFilterCtx, CourtDate, User, CalendarRouteParams } from '../types';
+import { ModalMode } from '../_components/Modal/types';
+import { CalEvent } from '../helpers/CalEvent';
+interface UseRouteSyncOptions {
+    currentView: string;
+    currentDate: Date;
+    selectedCourtDate: CourtDate | null;
+    modalIsOpen: boolean;
+    modalMode: ModalMode;
+    clickedCase: Case | null;
+    filterCtx: CalendarFilterCtx;
+    allDates: CourtDate[];
+    filteredDates: CalEvent[];
+    selectedCases: Case[];
+    isFetchingDates: boolean;
+    isFetchingCases: boolean;
+    lastFetchedAt: Date | null;
+    allUsers: Record<number, User>;
+    setCurrentView: (v: string) => void;
+    setCurrentDate: (d: Date) => void;
+    setFilterCtx: (ctx: CalendarFilterCtx) => void;
+    openDetailsModal: (calEvent: CalEvent) => void;
+    setClickedCase: (c: Case | null) => void;
+    routeParams?: CalendarRouteParams;
+    onRouteChange?: (params: CalendarRouteParams) => void;
+}
+export declare function useRouteSync({ currentView, currentDate, selectedCourtDate, modalIsOpen, modalMode, clickedCase, filterCtx, allDates, filteredDates, selectedCases, isFetchingDates, isFetchingCases, lastFetchedAt, allUsers, setCurrentView, setCurrentDate, setFilterCtx, openDetailsModal, setClickedCase, routeParams, onRouteChange, }: UseRouteSyncOptions): {
+    bootstrapError: string | null;
+    clearBootstrapError: () => void;
+};
+export {};

package/dist/index.d.ts

@@ -1 +1,3 @@
 export { default as CCalendar } from './_components/CCalendar';
+export type { CalendarRouteParams } from './types';
+export { parseCalendarSearchParams, serializeCalendarParams } from './helpers/routing';