@propriety/court-calendar 1.0.157 → 1.0.158

package/.vscode/extensions.json

@@ -0,0 +1,108 @@
+{
+  // Stack for this repo: React 19 + TypeScript + Vite (library mode) + Biome + Vitest + MUI 5.
+  // NOTE: "unwantedRecommendations" only suppresses VS Code's recommendation prompts.
+  // It does NOT disable an installed extension. To actually disable, either:
+  //   a) Extensions view -> right-click -> "Disable (Workspace)", or
+  //   b) import the profile at .vscode/court-calendar.code-profile (see README note below).
+  "recommendations": [
+    "biomejs.biome",
+    "yoavbls.pretty-ts-errors",
+    "antfu.vite",
+    "christian-kohler.path-intellisense",
+    "christian-kohler.npm-intellisense",
+    "eamodio.gitlens",
+    "github.vscode-pull-request-github"
+  ],
+
+  "unwantedRecommendations": [
+    // --- Formatter/linter conflicts: this repo uses Biome exclusively ---
+    "esbenp.prettier-vscode",
+    "dbaeumer.vscode-eslint",
+    "inferrinizzard.prettier-sql-vscode",
+
+    // --- Python stack (lives in ../adminAPI, ../Utility-API, ../pdfOcr) ---
+    "ms-python.python",
+    "ms-python.vscode-pylance",
+    "ms-python.debugpy",
+    "ms-python.black-formatter",
+    "ms-python.isort",
+    "ms-python.vscode-python-envs",
+    "charliermarsh.ruff",
+    "kevinrose.vsc-python-indent",
+
+    // --- Jupyter ---
+    "ms-toolsai.jupyter",
+    "ms-toolsai.jupyter-renderers",
+    "ms-toolsai.jupyter-keymap",
+    "ms-toolsai.vscode-jupyter-cell-tags",
+    "ms-toolsai.vscode-jupyter-slideshow",
+
+    // --- .NET / C# ---
+    "ms-dotnettools.csharp",
+    "ms-dotnettools.csdevkit",
+    "ms-dotnettools.vscode-dotnet-runtime",
+
+    // --- C / C++ / shaders ---
+    "ms-vscode.cpptools",
+    "jbenden.c-cpp-flylint",
+    "slevesque.shader",
+
+    // --- AutoHotkey (three overlapping extensions) ---
+    "cweijan.vscode-autohotkey-plus",
+    "mark-wiemer.vscode-autohotkey-plus-plus",
+    "thqby.vscode-autohotkey2-lsp",
+
+    // --- Other frameworks not used here (MUI + Emotion, no Tailwind/Vue/Sass) ---
+    "vue.volar",
+    "bradlc.vscode-tailwindcss",
+    "austenc.tailwind-docs",
+    "syler.sass-indented",
+    "glenn2223.live-sass",
+
+    // --- AWS / containers (belongs to ../lambdas) ---
+    "amazonwebservices.aws-toolkit-vscode",
+    "ms-azuretools.vscode-containers",
+    "ms-vscode-remote.remote-containers",
+
+    // --- Static/live servers: superseded by `npm run dev` (Vite) ---
+    "ritwickdey.liveserver",
+    "ms-vscode.live-server",
+    "george-alisson.html-preview-vscode",
+    "antfu.browse-lite",
+
+    // --- Redundant with built-in editor features (see .vscode/settings.json) ---
+    "formulahendry.auto-rename-tag",
+    "formulahendry.auto-close-tag",
+    "steoates.autoimport",
+    "kevinmcgowan.typescriptimport",
+    "donjayamanne.githistory",
+    "xyz.local-history",
+
+    // --- Continuous-CPU novelty extensions ---
+    "tonybaloney.vscode-pets",
+    "hoovercj.vscode-power-mode",
+
+    // --- Heavy eager extensions with no role in this repo ---
+    "shd101wyy.markdown-preview-enhanced",
+    "zignd.html-css-class-completion",
+    "ecmel.vscode-html-css",
+    "hwencc.html-tag-wrapper",
+    "kisstkondoros.vscode-gutter-preview",
+    "alefragnani.project-manager",
+    "ms-vsliveshare.vsliveshare",
+    "tamasfe.even-better-toml",
+
+    // --- Data/document viewers ---
+    "grapecity.gc-excelviewer",
+    "muhammad-ahmad.xlsx-viewer",
+    "mechatroner.rainbow-csv",
+    "tomoki1207.pdf",
+
+    // --- Misc unused languages ---
+    "eww-yuck.yuck",
+    "andrejunges.handlebars",
+    "mrmlnc.vscode-json5",
+    "idered.npm",
+    "petekinnecom.terminal-command-keys"
+  ]
+}

package/dist/__tests__/ApiFailureReporter.test.d.ts

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

package/dist/__tests__/CopyChip.test.d.ts

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

package/dist/__tests__/helpers/api/apiFailures.test.d.ts

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

package/dist/_components/ErrorReport/ApiFailureReporter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The single place a failed API call becomes visible.
+ *
+ * Deliberately **persistent** — no `autoHideDuration`. A four-second toast is how a failed
+ * delete went unnoticed in the first place; an error the user needs to report has to wait for
+ * them. Anchored top-center so it never collides with the transient bottom-center snackbars
+ * (saved / hidden-by-filter / bootstrap) that the calendar already uses.
+ *
+ * Mount once, high in the tree. It subscribes to the module-level failure bus in
+ * `helpers/api/apiFailures`, so it needs no props from the call sites that fail.
+ */
+export default function ApiFailureReporter({ activeUser }: {
+    activeUser?: number;
+}): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,13 @@
+/**
+ * Click-to-copy chip used for the identity fields on the Case Details panel
+ * (parcel ID, SCAR index number). Each instance owns its own "Copied!" state so
+ * copying one field never flips the tooltip on another.
+ *
+ * Renders as a `span` by default: `InfoField` wraps its value in a `Typography`
+ * (a `<p>`), and a `div` inside a `<p>` is invalid nesting.
+ */
+export default function CopyChip({ value, size, component, }: {
+    value: string;
+    size?: 'small' | 'medium';
+    component?: React.ElementType;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,68 @@
+/**
+ * A cross-cutting sink for API failures, so a request the server rejected always reaches the
+ * screen instead of only the console.
+ *
+ * Every helper in this folder reports failure by returning `false`/`null` and writing a
+ * `console.error` — which is why a delete the server refused looked identical to one that
+ * worked. Rather than change each helper's signature (and every call site, and every
+ * `.then(ok => …)` that depends on the boolean), each failing branch now *also* publishes an
+ * `ApiFailure` here. `ApiFailureReporter` subscribes on mount and renders whatever arrives.
+ *
+ * A module-level bus rather than React context because these fire from plain async functions
+ * that have no access to a provider — the same reason crash reporters are built this way.
+ *
+ * NOTE: nothing published here may contain the API key. The report is written to be pasted
+ * into a chat or ticket, so it carries the request *shape* (method, URL, status, response
+ * body) but never a credential.
+ */
+export interface ApiFailure {
+    /** What the user was trying to do, in their words: "Delete court date". */
+    operation: string;
+    /** Which record it was, e.g. "#1234 (Negotiations)". */
+    subject?: string;
+    method?: string;
+    url?: string;
+    /** `null` when the request never reached the server — offline, DNS, CORS, or a timeout. */
+    status: number | null;
+    /** One-line plain-English cause, shown to the user. */
+    detail: string;
+    /** Raw response body (or the thrown error's message), truncated. For the tech team. */
+    body?: string;
+    at: Date;
+}
+type Listener = (failure: ApiFailure) => void;
+/** Subscribe to API failures. Returns an unsubscribe function suitable for a `useEffect`. */
+export declare function onApiFailure(listener: Listener): () => void;
+/** Publish a failure to every subscriber. A throwing listener must not break the others. */
+export declare function publishApiFailure(failure: ApiFailure): void;
+/** Log and publish a non-2xx response. */
+export declare function reportHttpFailure(operation: string, method: string, url: string, res: Response, subject?: string): Promise<void>;
+/**
+ * Log and publish a request that never completed.
+ *
+ * `fetch` *rejects* rather than resolving with `ok: false` when the browser cannot reach the
+ * server at all — offline, DNS failure, a CORS preflight refusal, a dropped connection. Those
+ * used to escape as unhandled promise rejections from a click handler: no console error, no UI.
+ */
+export declare function reportNetworkFailure(operation: string, method: string, url: string, error: unknown, subject?: string): void;
+/**
+ * Publish an application-level problem that is not a single failed request — a partially
+ * applied save, for example, where each individual call succeeded or was already reported.
+ */
+export declare function reportProblem(problem: {
+    operation: string;
+    subject?: string;
+    detail: string;
+    body?: string;
+}): void;
+/**
+ * The copy-paste block handed to the tech team.
+ *
+ * Written for a chat message or ticket: fixed-width, no markdown, and self-contained — whoever
+ * receives it should not have to ask "which record?", "what time?", or "what did the server
+ * actually say?". Carries no API key (see the file header).
+ */
+export declare function formatFailureReport(failures: ApiFailure[], context?: {
+    activeUser?: number;
+}): string;
+export {};

package/dist/helpers/clipboard.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copy text to the clipboard, reporting honestly whether it worked.
+ *
+ * `navigator.clipboard` is unavailable on insecure origins and *rejects* when the document
+ * isn't focused or the permission was denied — so a bare `writeText()` can silently leave the
+ * clipboard empty while the UI says "Copied". Both paths are tried and the caller is told
+ * which happened, so a failure can fall back to showing the text for manual selection.
+ */
+export declare function copyText(text: string): Promise<boolean>;

package/dist/hooks/UseModalActions.d.ts

@@ -17,7 +17,8 @@ import { ModalMode } from '../_components/Modal/types';
  *
  * @returns
  * - `handleSave`                        – Validates and persists the edited court date (creates or updates).
- * - `handleDelete`                      – Confirms, then deletes the selected court date.
+ * - `handleDelete`                      – Confirms, then deletes the selected court date. Returns
+ *                                        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.
  * - `handleSelectedCasesClearDetermination` – Clears the determination for a set of cases (backend only clears `D`), then reconciles with the server.
@@ -33,7 +34,7 @@ export declare function useModalActions({ modalMode, selectedCourtDate, selected
     pendingNoticeFiles?: File[];
 }): {
     handleSave: () => Promise<boolean>;
-    handleDelete: () => Promise<void>;
+    handleDelete: () => Promise<boolean>;
     handleViewUpdateChair: (position: "first" | "second", userId: number | null) => void;
     handleSelectedCasesAdjournmentChange: (casesToUpdate: Case[], date: Date | null) => Promise<boolean>;
     handleSelectedCasesClearDetermination: (casesToUpdate: Case[]) => Promise<boolean>;