@propriety/court-calendar 1.0.128 → 1.0.129

package/.claude/agents/library-api-reviewer.md

@@ -0,0 +1,22 @@
+---
+name: library-api-reviewer
+description: Reviews changes to @propriety/court-calendar for public API compatibility — breaking prop changes, removed exports, peer dep violations. Invoke before opening a PR or publishing.
+---
+
+You are a library API compatibility reviewer for `@propriety/court-calendar`.
+
+Analyze the current diff or staged changes and identify:
+
+1. **Removed or renamed exports** — check `src/index.ts` for anything removed or renamed that consumers may depend on
+2. **Breaking prop changes** — removed props, changed types (stricter or different), new required props added to existing components
+3. **Peer dependency violations** — code that directly imports from `@mui/`, `@emotion/`, `react`, `react-dom` without accounting for them being peer deps (they must not be bundled)
+4. **Type regressions** — public TypeScript types that became more restrictive or were removed
+5. **Dexie schema changes** — any changes to IndexedDB stores in `src/` must handle version migrations
+6. **Context API surface** — changes to `ReferenceDataContext` shape affect all consumers of `useReferenceData()`
+
+Output a verdict:
+- **BREAKING** — consumers on the previous version will break on upgrade; needs a major version bump
+- **NON-BREAKING** — new features or additions only; minor version bump appropriate
+- **PATCH** — bug fixes with no API surface changes
+
+Include specifics: which files changed, what the impact is, and the recommended semver bump.

package/.claude/settings.json

@@ -0,0 +1,19 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const i=JSON.parse(process.env.CLAUDE_TOOL_INPUT||'{}');const f=i.file_path||'';if((f.endsWith('.ts')||f.endsWith('.tsx'))&&!f.includes('dist/')){const cp=require('child_process');try{cp.execSync('npx biome format --write '+JSON.stringify(f),{stdio:'pipe',cwd:'c:/Users/Optiplex-BFHN/projects/court-calendar'})}catch(e){}}\""
+          },
+          {
+            "type": "command",
+            "command": "node -e \"const i=JSON.parse(process.env.CLAUDE_TOOL_INPUT||'{}');const f=i.file_path||'';if((f.endsWith('.ts')||f.endsWith('.tsx'))&&!f.includes('.test.')&&f.includes('src/')){const cp=require('child_process');try{cp.execSync('npx vitest run --related '+JSON.stringify(f),{stdio:'pipe',cwd:'c:/Users/Optiplex-BFHN/projects/court-calendar',timeout:30000})}catch(e){}}\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude/skills/gen-test/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: gen-test
+description: Generate Vitest + React Testing Library tests for a court-calendar component or hook
+---
+
+Generate tests for the `@propriety/court-calendar` library targeting the file or subject passed as $ARGUMENTS.
+
+## Project Test Conventions
+- Test files live in `src/__tests__/` named `<subject>.test.ts(x)`
+- Shared fixtures: `src/__tests__/fixtures.ts` — read this first for reusable test data
+- Shared helpers: `src/__tests__/helpers/`
+- Hook test utilities: `src/__tests__/hooks/`
+- Vitest globals (`describe`, `it`, `expect`, `vi`) are auto-imported — no import needed
+- Use `renderHook` from `@testing-library/react` for custom hooks
+- Mock context modules: `vi.mock('@/context/ReferenceDataContext', () => ({ useReferenceData: vi.fn(() => ({ allUsers: [], allHearingOfficers: [], allMuniNames: [], isLoading: false })) }))`
+
+## Steps
+1. Read the target file to understand its props, return values, and side effects
+2. Read `src/__tests__/fixtures.ts` for available court case / event test data
+3. Scan `src/__tests__/helpers/` and `src/__tests__/hooks/` for setup utilities to reuse
+4. Write tests covering: happy path, edge cases, null/undefined inputs, and loading states
+5. Place output in `src/__tests__/<subject>.test.ts(x)`
+
+Target: $ARGUMENTS

package/.claude/skills/release-prep/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: release-prep
+description: Prepare @propriety/court-calendar for npm publish — runs all checks, prompts for version bump, builds dist
+---
+
+Run the full release checklist for `@propriety/court-calendar`. Stop and report on first failure.
+
+## Steps (sequential — stop on failure)
+1. `npx tsc --noEmit` — type check must pass with zero errors
+2. `npx vitest run` — all tests must pass
+3. `npx biome check src/` — no lint or format violations
+4. Ask the user: **patch / minor / major** version bump? (default: patch)
+   - Update the `version` field in `package.json` accordingly
+5. `npm run build` — must succeed
+6. Verify `dist/index.mjs` and `dist/index.d.ts` exist and are non-empty
+7. Report: new version number, dist file sizes, ready to `npm publish`
+
+Bump type from $ARGUMENTS (default: patch if not provided).

package/CLAUDE.md

@@ -0,0 +1,41 @@
+# court-calendar
+
+Published npm package: `@propriety/court-calendar` — a React component library built with Vite in library mode.
+
+## 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
+```
+
+## Architecture
+
+- **Entry**: `src/index.ts` → exports `CCalendar` component from `src/_components/CCalendar.tsx`
+- **Path alias**: `@/` resolves to `./src/`
+- **Build output**: `dist/index.mjs` (ES module) + `dist/index.d.ts` (types)
+- **Peer deps** (not bundled): React, react-dom, MUI 5, Emotion — `vite.config.ts` externalizes these
+
+## Key Pattern: ReferenceDataContext
+
+Reference data (users, hearing officers, municipalities) is fetched once in `ReferenceDataProvider` (wrapped inside `CCalendar`) and consumed via `useReferenceData()` in child components. Do **not** fetch this data at the module level or use top-level await.
+
+Context is at `src/context/ReferenceDataContext.tsx` and provides: `allUsers`, `allHearingOfficers`, `allMuniNames`, `getTownshipName`, `getCountyName`, `isLoading`.
+
+## Runtime Config
+
+`import.meta.env` values are baked in at **library build time**, not consumer runtime. Pass runtime config (API keys, endpoints) as React props and thread them through context — never read env vars in library code.
+
+## Component Props
+
+`CCalendar` accepts:
+- `apiKey` — runtime API key (passed through context, not env var)
+- `activeUser` — the currently logged-in user object
+
+## Tooling
+
+- **Formatter/Linter**: Biome — not Prettier or ESLint
+- **Tests**: Vitest + @testing-library/react. Files: `src/__tests__/`, fixtures: `src/__tests__/fixtures.ts`
+- **Pre-commit**: Husky runs on commit — run `npx biome format --write` before staging

package/dist/index.mjs

@@ -20697,7 +20697,7 @@ function N1({
           bottom: 24,
           left: "50%",
           transform: "translateX(-50%)",
-          zIndex: 9999,
+          zIndex: 100,
           pointerEvents: "none",
           animation: v === "in" ? "lb-slide-up 0.3s cubic-bezier(0.34,1.56,0.64,1) forwards" : v === "out" ? "lb-slide-down 0.45s ease forwards" : "none"
         },
@@ -20788,14 +20788,7 @@ function N1({
                             children: b
                           }
                         ),
-                        /* @__PURE__ */ a(
-                          Zr,
-                          {
-                            size: 14,
-                            thickness: 5,
-                            sx: { color: "#8b5cf6", flexShrink: 0 }
-                          }
-                        )
+                        /* @__PURE__ */ a(Zr, { size: 14, thickness: 5, sx: { color: "#8b5cf6", flexShrink: 0 } })
                       ]
                     }
                   ),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@propriety/court-calendar",
   "private": false,
-  "version": "1.0.128",
+  "version": "1.0.129",
   "type": "module",
   "main": "dist/index.js",
   "module": "./dist/index.mjs",

package/src/_components/LoadingBar.tsx

@@ -1,8 +1,8 @@
-import { useEffect, useRef, useState } from "react";
-import humphreyImg from "@/assets/humphrey.png";
-import Box from "@mui/material/Box";
-import Typography from "@mui/material/Typography";
-import CircularProgress from "@mui/material/CircularProgress";
+import { useEffect, useRef, useState } from 'react';
+import humphreyImg from '@/assets/humphrey.png';
+import Box from '@mui/material/Box';
+import Typography from '@mui/material/Typography';
+import CircularProgress from '@mui/material/CircularProgress';
 
 interface LoadingBarProps {
     isFetchingDates: boolean;
@@ -13,8 +13,7 @@ interface LoadingBarProps {
     isFiltering?: boolean;
 }
 
-const GRADIENT =
-    "linear-gradient(135deg, #3b82f6 0%, #8b5cf6 50%, #06b6d4 100%)";
+const GRADIENT = 'linear-gradient(135deg, #3b82f6 0%, #8b5cf6 50%, #06b6d4 100%)';
 
 export default function LoadingBar({
     isFetchingDates,
@@ -26,19 +25,19 @@ export default function LoadingBar({
 }: LoadingBarProps) {
     const isLoading = isFetchingDates || isFetchingCases || isSearching || isFiltering;
     const [visible, setVisible] = useState(false);
-    const [animating, setAnimating] = useState<"in" | "out" | "idle">("idle");
+    const [animating, setAnimating] = useState<'in' | 'out' | 'idle'>('idle');
     const hideTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
     useEffect(() => {
         if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
         if (isLoading) {
             setVisible(true);
-            setAnimating("in");
+            setAnimating('in');
         } else {
-            setAnimating("out");
+            setAnimating('out');
             hideTimerRef.current = setTimeout(() => {
                 setVisible(false);
-                setAnimating("idle");
+                setAnimating('idle');
             }, 500);
         }
         return () => {
@@ -54,14 +53,14 @@ export default function LoadingBar({
             : Math.min(loadedCount / totalCount, 1);
 
     const label = isFetchingDates
-        ? "Loading court dates…"
+        ? 'Loading court dates…'
         : isSearching
-          ? "Searching…"
+          ? 'Searching…'
           : isFiltering && !isFetchingCases
-            ? "Filtering…"
+            ? 'Filtering…'
             : progress !== null
               ? `Loading cases — ${loadedCount} / ${totalCount}`
-              : "Loading…";
+              : 'Loading…';
 
     return (
         <>
@@ -69,48 +68,47 @@ export default function LoadingBar({
             {/* Outer positioning wrapper */}
             <Box
                 sx={{
-                    position: "fixed",
+                    position: 'fixed',
                     bottom: 24,
-                    left: "50%",
-                    transform: "translateX(-50%)",
-                    zIndex: 9999,
-                    pointerEvents: "none",
+                    left: '50%',
+                    transform: 'translateX(-50%)',
+                    zIndex: 100,
+                    pointerEvents: 'none',
                     animation:
-                        animating === "in"
-                            ? "lb-slide-up 0.3s cubic-bezier(0.34,1.56,0.64,1) forwards"
-                            : animating === "out"
-                              ? "lb-slide-down 0.45s ease forwards"
-                              : "none",
+                        animating === 'in'
+                            ? 'lb-slide-up 0.3s cubic-bezier(0.34,1.56,0.64,1) forwards'
+                            : animating === 'out'
+                              ? 'lb-slide-down 0.45s ease forwards'
+                              : 'none',
                 }}
             >
                 {/* Gradient border shell + glow shadow */}
                 <Box
                     sx={{
                         background: GRADIENT,
-                        borderRadius: "26px",
-                        p: "1.5px",
+                        borderRadius: '26px',
+                        p: '1.5px',
                         boxShadow:
-                            "0 0 18px 2px rgba(139,92,246,0.35), 0 0 8px 1px rgba(59,130,246,0.25), 0 4px 16px rgba(0,0,0,0.18)",
+                            '0 0 18px 2px rgba(139,92,246,0.35), 0 0 8px 1px rgba(59,130,246,0.25), 0 4px 16px rgba(0,0,0,0.18)',
                     }}
                 >
                     {/* Inner content card */}
                     <Box
                         sx={{
-                            backgroundColor: "var(--bg)",
-                            borderRadius: "24px",
+                            backgroundColor: 'var(--bg)',
+                            borderRadius: '24px',
                             px: 2.25,
                             pt: 1,
                             pb: progress !== null ? 1.25 : 1,
                             minWidth: 220,
                             maxWidth: 340,
-                            fontFamily:
-                                '"Roboto","Helvetica","Arial",sans-serif',
+                            fontFamily: '"Roboto","Helvetica","Arial",sans-serif',
                         }}
                     >
                         <Box
                             sx={{
-                                display: "flex",
-                                alignItems: "center",
+                                display: 'flex',
+                                alignItems: 'center',
                                 gap: 1,
                                 mb: progress !== null ? 0.75 : 0,
                             }}
@@ -118,7 +116,7 @@ export default function LoadingBar({
                             {/* Humphrey avatar with gradient ring */}
                             <Box
                                 sx={{
-                                    position: "relative",
+                                    position: 'relative',
                                     flexShrink: 0,
                                     width: 28,
                                     height: 28,
@@ -126,43 +124,39 @@ export default function LoadingBar({
                             >
                                 <Box
                                     sx={{
-                                        position: "absolute",
+                                        position: 'absolute',
                                         inset: -1.5,
-                                        borderRadius: "50%",
+                                        borderRadius: '50%',
                                         background: GRADIENT,
                                         zIndex: 0,
                                     }}
                                 />
                                 <Box
-                                    component="img"
+                                    component='img'
                                     src={humphreyImg}
                                     sx={{
-                                        position: "relative",
+                                        position: 'relative',
                                         zIndex: 1,
                                         width: 28,
                                         height: 28,
-                                        borderRadius: "50%",
-                                        objectFit: "cover",
-                                        border: "1.5px solid var(--bg)",
+                                        borderRadius: '50%',
+                                        objectFit: 'cover',
+                                        border: '1.5px solid var(--bg)',
                                     }}
                                 />
                             </Box>
                             <Typography
-                                variant="body2"
+                                variant='body2'
                                 sx={{
                                     fontWeight: 500,
-                                    whiteSpace: "nowrap",
-                                    color: "var(--text)",
+                                    whiteSpace: 'nowrap',
+                                    color: 'var(--text)',
                                     fontSize: 13,
                                 }}
                             >
                                 {label}
                             </Typography>
-                            <CircularProgress
-                                size={14}
-                                thickness={5}
-                                sx={{ color: "#8b5cf6", flexShrink: 0 }}
-                            />
+                            <CircularProgress size={14} thickness={5} sx={{ color: '#8b5cf6', flexShrink: 0 }} />
                         </Box>
 
                         {progress !== null && (
@@ -170,17 +164,17 @@ export default function LoadingBar({
                                 sx={{
                                     height: 4,
                                     borderRadius: 1,
-                                    backgroundColor: "var(--fc-border-color)",
-                                    overflow: "hidden",
+                                    backgroundColor: 'var(--fc-border-color)',
+                                    overflow: 'hidden',
                                 }}
                             >
                                 <Box
                                     sx={{
-                                        height: "100%",
+                                        height: '100%',
                                         width: `${progress * 100}%`,
                                         borderRadius: 1,
                                         background: GRADIENT,
-                                        transition: "width 0.3s ease",
+                                        transition: 'width 0.3s ease',
                                     }}
                                 />
                             </Box>