@propriety/court-calendar 1.0.184 → 1.0.186

package/README.md

@@ -44,7 +44,7 @@ import '@propriety/court-calendar/styles.css';
 | `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). |
-| `checkAdminVersion` | `boolean` | `true` | Fetches Admin's `/version.json` and shows a notice above the calendar when Admin runs a newer calendar release. Dismissing it hides it for 7 days. Admin itself passes `false`. |
+| `checkAdminVersion` | `boolean` | `true` | Fetches Admin's `/version.json` and shows a slim notice inside the calendar, above its toolbar, when Admin runs a newer calendar release. It never covers or blocks anything, and shows nothing if Admin can't be reached. Dismissing it hides it for 7 days. Admin itself passes `false`. |
 
 ---
 
@@ -219,7 +219,7 @@ Parameters use short keys to keep the address bar readable. Only non-default val
 | `dl` | `showUploadDeadlines` | `false` | `dl=1` when true |
 | `adj` | `showAdjournmentDates` | `true` | `adj=0` when false |
 | `dt` | `dateTypeFilter` | `'all'` | `scar`, `negotiations`, or `collections` |
-| `muni` | `municode` | `null` | Municipality code string |
+| `muni` | `municode` | `null` | Municipality code string, or a one-letter county code (`N`) for the whole county |
 | `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 |
@@ -262,7 +262,7 @@ If a `cdId` or `ci` value in the URL doesn't match any loaded data, a brief erro
 | Component | Description |
 |-----------|-------------|
 | `CCalendar` | Root component. Manages state, events, filtering, and renders the calendar + modal. |
-| `Toolbar` | Navigation and filter controls (date type, hearing type, case filters, user filter, view switcher, municipality dropdown, search). |
+| `Toolbar` | Navigation and filter controls (date type, hearing type, case filters, user filter, view switcher, municipality/county dropdown, search). |
 | `CalendarList` | MUI DataGrid table view of court dates with color-coded status, county, and location columns. |
 | `Modal` | Dialog with 4 modes: Details, Edit, Create, Case Details. |
 | `CreateEditCase` | Form for court date fields (dates, municipality, hearing details, chair assignments, case IDs). |
@@ -289,7 +289,7 @@ If a `cdId` or `ci` value in the URL doesn't match any loaded data, a brief erro
 | `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/courtDates.ts` | `caseKey` (memory-map key), `isVillageDate` (municipality code check), `isCountyCode` (one-letter county code). |
 | `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. |

package/dist/_components/Shared/CountyDropdown.d.ts

@@ -3,8 +3,8 @@
  * than one municipality. The selected value is stored in the same MuniCode field every
  * other date type uses, but holds a county code ('N') instead of a muni code ('N2000').
  *
- * Deliberately not part of MuniDropdown: only collections may pick a county, and county
- * entries must never appear in the municipality list.
+ * Deliberately not part of MuniDropdown: only collections may be *assigned* a county. The
+ * toolbar filter lists counties through MuniDropdown's `includeCounties`, which only narrows the view.
  */
 export default function CountyDropdown({ selectedCounty, setSelectedCounty, size, onOpen, onClose, }: {
     selectedCounty: string | null;

package/dist/_components/Shared/MuniDropdown.d.ts

@@ -1,8 +1,10 @@
-export default function MuniDropdown({ selectedMuni, setSelectedMuni, allowClear, size, onOpen, onClose, }: {
+export default function MuniDropdown({ selectedMuni, setSelectedMuni, allowClear, size, onOpen, onClose, includeCounties, }: {
     selectedMuni: string | null;
     setSelectedMuni: (muni: string) => void;
     allowClear: boolean;
     size: 'small' | 'medium';
     onOpen?: () => void;
     onClose?: () => void;
+    /** Filters only. Where the pick becomes a date's MuniCode, a county code would file a SCAR date under a whole county. */
+    includeCounties?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -6,7 +6,7 @@
  * scheduled per county rather than per municipality and store one of these codes
  * in MuniCode.
  *
- * Deliberately a separate endpoint from /utils/get-muni-names: county codes must
- * not appear in the municipality dropdown.
+ * Deliberately a separate endpoint from /utils/get-muni-names: county codes must not
+ * appear where the municipality dropdown assigns a date's muni, only where it filters.
  */
 export declare function getAllCounties(apiKey: string): Promise<Record<string, string>>;

package/dist/helpers/courtDates.d.ts

@@ -1,5 +1,7 @@
 import { DateType, HearingType, Case, CourtDate } from '../types';
 export declare function isVillageDate(muniCode: string): boolean;
+/** A county code is the letter every muni code in that county starts with: 'N' covers 'N05' and 'N2005'. */
+export declare function isCountyCode(muniCode: string): boolean;
 /**
  * The CSS class that paints a hearing type — `.inperson`, `.virtual`, `.unknown` in
  * CalendarEvents.css.