refactor(astro): ♻️ Move shared React components to common directory

Move reusable components and utilities (`useDataLoader`,
`QueryProvider`, `PrivacyToggleCompact`) into the `common`
directory to improve organization and reduce duplication.

Also includes:
* Add boilerplate `index.ts` files with copyright headers to component folders.
* Improve typing clarity in dashboard components.
* Add CSS fallback animation for progressive enhancement reveal state.

Author: WomB0ComB0

apps/api/src/services/agencies/agency-search.service.ts

@@ -29,8 +29,6 @@
  * @compliance NIST 800-53 SI-10 (Information Input Validation)
  */
 
-import { db, schema } from '@/db';
-import type { Agency } from '@/types';
 import {
   createAgencyHierarchy,
   createAgencyTrie,
@@ -41,6 +39,9 @@ import {
 } from '@foia-stream/shared';
 import { Schema as S } from 'effect';
 
+import { db, schema } from '@/db';
+import type { Agency } from '@/types';
+
 // ============================================
 // Types
 // ============================================

apps/astro/src/components/react/agencies/index.ts

@@ -1,2 +1,24 @@
+/**
+ * Copyright (c) 2025 Foia Stream
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 export { default as AgenciesPage } from './agencies-page';
 export { default as AgencySearch } from './agency-search';

apps/astro/src/components/react/auth/index.ts

@@ -1,3 +1,25 @@
+/**
+ * Copyright (c) 2025 Foia Stream
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 export { default as LoginForm } from './login-form';
 export { default as Onboarding } from './onboarding';
 export { default as RegisterForm } from './register-form';

apps/astro/src/components/react/auth/onboarding.tsx

@@ -27,7 +27,7 @@
 
 import { ArrowRight, Check, ChevronLeft, FileText, Search, Send, Sparkles } from 'lucide-react';
 import { useEffect, useState } from 'react';
-import { $user, useAuthStore } from '@/stores/auth';
+import { useAuthStore } from '@/stores/auth';
 
 /**
  * Onboarding step configuration

apps/astro/src/components/react/common/index.ts

@@ -1,3 +1,25 @@
+/**
+ * Copyright (c) 2025 Foia Stream
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 export { default as EffectDataLoader } from './effect-data-loader';
 export { EmptyState, ErrorBoundary, ErrorDisplay } from './error-boundary';
 export { default as PrivacyToggle } from './privacy-toggle';

apps/astro/src/components/react/dashboard/dashboard-content.tsx

@@ -26,10 +26,6 @@
  * @author FOIA Stream Team
  */
 
-import type { FoiaRequest } from '@/lib/api';
-import { API_BASE } from '@/lib/config';
-import { formatDate, getStatusColor } from '@/lib/utils';
-import { initAuth, logout, useAuthStore } from '@/stores/auth';
 import {
   Building2,
   ChevronDown,
@@ -43,7 +39,12 @@ import {
   User,
 } from 'lucide-react';
 import { Suspense, useEffect, useRef, useState } from 'react';
-import { useDataLoader } from './effect-data-loader';
+
+import type { FoiaRequest } from '@/lib/api';
+import { API_BASE } from '@/lib/config';
+import { formatDate, getStatusColor } from '@/lib/utils';
+import { initAuth, logout, useAuthStore } from '@/stores/auth';
+import { useDataLoader } from '../common/effect-data-loader';
 
 interface RequestsResponse {
   data: FoiaRequest[];
@@ -64,7 +65,7 @@ function RequestsList({ onRefetch }: { onRefetch?: (refetch: () => Promise<void>
     refetchOnWindowFocus: false,
   });
 
-  const requests = data?.data || [];
+  const requests: FoiaRequest[] = data?.data || [];
 
   useEffect(() => {
     if (onRefetch) {
@@ -129,12 +130,13 @@ function DashboardStats() {
     refetchOnWindowFocus: false,
   });
 
-  const requests = data?.data || [];
+  const requests: FoiaRequest[] = data?.data || [];
 
   const pendingCount = requests.filter(
-    (r) => r.status === 'submitted' || r.status === 'processing' || r.status === 'acknowledged',
+    (r: FoiaRequest) =>
+      r.status === 'submitted' || r.status === 'processing' || r.status === 'acknowledged',
   ).length;
-  const completedCount = requests.filter((r) =>
+  const completedCount = requests.filter((r: FoiaRequest) =>
     [
       'fulfilled',
       'partially_fulfilled',
@@ -144,7 +146,7 @@ function DashboardStats() {
       'withdrawn',
     ].includes(r.status),
   ).length;
-  const uniqueAgencies = new Set(requests.map((r) => r.agencyId)).size;
+  const uniqueAgencies = new Set(requests.map((r: FoiaRequest) => r.agencyId)).size;
 
   return (
     <div className="mb-8 grid grid-cols-1 gap-4 md:grid-cols-4">

apps/astro/src/components/react/dashboard/dashboard-with-query.tsx

@@ -26,8 +26,8 @@
  * @author FOIA Stream Team
  */
 
+import { QueryProvider } from '../common/query-provider';
 import DashboardContent from './dashboard-content';
-import { QueryProvider } from './query-provider';
 
 /**
  * Dashboard component wrapped with QueryProvider for TanStack Query support.

apps/astro/src/components/react/dashboard/dashboard.tsx

@@ -25,10 +25,6 @@
  * @module components/react/Dashboard
  */
 
-import { api, type FoiaRequest } from '@/lib/api';
-import { formatDate, getStatusColor } from '@/lib/utils';
-import { initAuth, logout, useAuthStore } from '@/stores/auth';
-import { maybeRedact, redactName, usePrivacyStore } from '@/stores/privacy';
 import {
   Building2,
   Check,
@@ -48,7 +44,12 @@ import {
   X,
 } from 'lucide-react';
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { PrivacyToggleCompact } from './privacy-toggle';
+
+import { api, type FoiaRequest } from '@/lib/api';
+import { formatDate, getStatusColor } from '@/lib/utils';
+import { initAuth, logout, useAuthStore } from '@/stores/auth';
+import { maybeRedact, redactName, usePrivacyStore } from '@/stores/privacy';
+import { PrivacyToggleCompact } from '../common/privacy-toggle';
 
 /**
  * Main dashboard component showing request statistics and list

apps/astro/src/components/react/dashboard/index.ts

@@ -1,3 +1,25 @@
+/**
+ * Copyright (c) 2025 Foia Stream
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 export { default as Dashboard } from './dashboard';
 export { default as DashboardContent } from './dashboard-content';
 export { default as DashboardWithQuery } from './dashboard-with-query';

apps/astro/src/components/react/documents/index.ts

@@ -1,3 +1,25 @@
+/**
+ * Copyright (c) 2025 Foia Stream
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
 export { default as DocumentViewer } from './document-viewer';
 export { default as DocumentsPage } from './documents-page';
 export { default as PDFRedactionViewer } from './pdf-redaction-viewer';