@propriety/court-calendar 1.0.173 → 1.0.175

package/CLAUDE.md

@@ -2,15 +2,30 @@
 
 Published npm package: `@propriety/court-calendar` — a React component library built with Vite in library mode.
 
+## Read this before debugging anything
+
+**[docs/REFERENCE.md](docs/REFERENCE.md)** — the data model (three date types in three tables, one
+`CourtDate` shape), the call path a mutation travels, the permission gates, and a table of traps
+that each cost a real debugging session. Most bugs here look like frontend bugs and are one of
+those. Read it before forming a hypothesis, and add to it when a session rediscovers something
+structural.
+
 ## Commands
 
 ```bash
 npm run build                        # tsc -b && vite build → dist/
-npx vitest run                       # run all tests
-npx biome format --write <file>      # format a file
-npx biome check src/                 # lint entire src
+npx tsc -b                           # typecheck only
+npx vitest run                       # run all tests (~1260 of them, ~60s)
+npx biome lint <file>                # lint — this is the useful one
 ```
 
+- `npx biome check` reports whole-file **format** drift on almost every file at `HEAD`: the repo is
+  not biome-formatted. Judge your own edit with `biome lint`. Never `biome format --write` a whole
+  file — it buries the change under hundreds of lines.
+- `npm run lint` is a leftover from the Vite template (`eslint .`, and there is no eslint config
+  here — only `biome.json`). The `eslint-disable-next-line` comments in `src/` are vestigial.
+- `rtk` is not installed on this machine, despite the global instruction to prefix with it.
+
 ## Architecture
 
 - **Entry**: `src/index.ts` → exports `CCalendar` component from `src/_components/CCalendar.tsx`
@@ -44,4 +59,5 @@ Context is at `src/context/ReferenceDataContext.tsx` and provides: `allUsers`, `
   failure is plausible. If you cannot name the bug, do not write the test. Never assert on the text
   of a file, a private helper's internals, or a constant equalling itself. `/test-audit` applies this
   retroactively.
-- **Pre-commit**: Husky runs on commit — run `npx biome format --write` before staging
+- **Git hooks**: one only — Husky `pre-push` runs `npm test`. There is no pre-commit hook and
+  nothing formats on commit, so do not reformat files to satisfy an imagined one.

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

@@ -1,5 +1,5 @@
 import { ModalMode } from '../types';
-export default function ModalActions({ modalMode, onDelete, onSave, setModalMode, setIsOpen, canEdit, isAdmin, createdBy, createdOn, }: {
+export default function ModalActions({ modalMode, onDelete, onSave, setModalMode, setIsOpen, canEdit, isAdmin, courtDateId, createdBy, createdOn, }: {
     modalMode: ModalMode;
     onDelete: () => void | Promise<unknown>;
     onSave: () => void | Promise<unknown>;
@@ -7,8 +7,19 @@ export default function ModalActions({ modalMode, onDelete, onSave, setModalMode
     setIsOpen: (isOpen: boolean) => void;
     /** Gates Edit/Save — everyone who works on cases. */
     canEdit: boolean;
-    /** Gates Delete only. Deleting a date is not recoverable from the UI. */
+    /**
+     * Gates Delete, and is the whole gate. Deleting a date is not recoverable from the UI,
+     * so the protection is the permission plus `handleDelete`'s confirm — not obscurity.
+     * Delete used to be hidden behind an unlabelled triple-click on a blank strip in this
+     * footer, which admins could not find and which broke outright whenever anything else
+     * in the row needed the space.
+     */
     isAdmin: boolean;
+    /**
+     * The row Delete would act on, or undefined/null while it is still unresolved. Only a
+     * positive id is a real saved date — CREATE's stub is -1 and `DEFAULT_COURT_DATE` is 0.
+     */
+    courtDateId?: number | null;
     createdBy?: number | null;
     createdOn?: Date | string | null;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/helpers/CalEvent.d.ts

@@ -23,6 +23,17 @@ export interface CalEvent {
     casesLoaded: boolean;
     source: CourtDate;
 }
+/**
+ * `date` with `hearingTime`'s clock folded in, as a new Date. A blank or unparseable time
+ * leaves the date's own clock alone.
+ *
+ * Parsing is delegated to `to24Hour` rather than repeated here. The local parser this
+ * replaced read anything without a "PM" suffix as 12-hour AM, so a bare "12:00" folded to
+ * midnight. HearingTime holds both dialects — "10:00 AM" written by the notice ingest,
+ * "12:00" written by the modal's TimePicker — and noon is the single value where they
+ * disagree, so a 12pm hearing drew at 12am.
+ */
+export declare function withHearingTime(date: Date | string | number, hearingTime: string | null | undefined): Date;
 /** 'YYYY-MM-DD' in local time — the identity of a calendar day, used to bucket by day. */
 export declare function dateToKey(d: Date): string;
 /**