chore(core): implement senior-grade quality and dx improvements

- feat: add example CI pipeline config (disabled by default)

- sec: enable strict 'noExplicitAny' and 'noDangerouslySetInnerHtml'

- fix: mount Sonner Toaster in root router for global access

- fix: ensure strict type safety on next-themes to sonner props

- fix: resolve non-null assertion in main.tsx with runtime check

- perf: improve QueryClient defaults with proper gcTime and retries

- dev: configure React Query DevTools for runtime debugging

- style: rename use-mobile.tsx to .ts as it lacks JSX

- chore: configure test script with --passWithNoTests

- chore: optimize husky pre-commit to use lint-staged

- chore: remove dead interceptor code from api instance

- chore: add explicit folders for features, services and store

Author: pasqualinigui

.biomeignore

@@ -0,0 +1,49 @@
+# TEMPLATE SENIOR REACT - CI Pipeline Example
+# ----------------------------------------------------------------------
+# Este arquivo é providenciado apenas como referência e está DESATIVADO.
+# Sendo este repositório um "Template/Boilerplate", não rodamos CI
+# automáticos nele.
+#
+# Para ativar o CI na sua própria aplicação que nascer deste template,
+# remova os comentários (#) abaixo.
+# ----------------------------------------------------------------------
+
+# name: CI Pipeline
+# 
+# on:
+#   push:
+#     branches: [main]
+#   pull_request:
+#     branches: [main]
+# 
+# jobs:
+#   build-lint-test:
+#     runs-on: ubuntu-latest
+#     steps:
+#       - name: Checkout Repository
+#         uses: actions/checkout@v4
+# 
+#       - name: Setup Node.js
+#         uses: actions/setup-node@v4
+#         with:
+#           node-version: '20'
+# 
+#       - name: Setup pnpm
+#         uses: pnpm/action-setup@v4
+#         with:
+#           version: 10.33.0
+# 
+#       - name: Install Dependencies
+#         run: pnpm install --frozen-lockfile
+# 
+#       - name: Typecheck
+#         run: pnpm run typecheck
+# 
+#       - name: Lint (Biome)
+#         run: pnpm run lint
+# 
+#       - name: Test (Vitest)
+#         run: pnpm run test --passWithNoTests
+# 
+#       - name: Build
+#         run: pnpm run build

.github/workflows/ci.yml

@@ -1 +1 @@
-pnpm typecheck && pnpm lint:fix
+pnpm typecheck && pnpm dlx lint-staged

.husky/pre-commit

@@ -7,7 +7,7 @@
   },
   "files": {
     "ignoreUnknown": false,
-    "includes": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.js", "src/**/*.jsx"]
+    "includes": ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.json", "**/*.css"]
   },
   "formatter": {
     "enabled": true,
@@ -38,13 +38,13 @@
         "useExhaustiveDependencies": "warn"
       },
       "suspicious": {
-        "noExplicitAny": "off",
+        "noExplicitAny": "error",
         "noEmptyInterface": "warn",
         "noArrayIndexKey": "error",
         "noDocumentCookie": "off"
       },
       "security": {
-        "noDangerouslySetInnerHtml": "off"
+        "noDangerouslySetInnerHtml": "warn"
       },
       "a11y": {
         "useFocusableInteractive": "off",
@@ -80,5 +80,17 @@
         "organizeImports": "on"
       }
     }
-  }
+  },
+  "overrides": [
+    {
+      "includes": ["src/routeTree.gen.ts"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noExplicitAny": "off"
+          }
+        }
+      }
+    }
+  ]
 }

biome.json

@@ -17,7 +17,7 @@
     "lint:fix": "biome check --write . || true",
     "format": "biome format --write .",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run",
+    "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
     "prepare": "husky"
   },
@@ -79,6 +79,7 @@
     "@fontsource-variable/geist": "^5.2.8",
     "@tailwindcss/typography": "^0.5.19",
     "@tailwindcss/vite": "^4.2.2",
+    "@tanstack/react-query-devtools": "^5.95.2",
     "@tanstack/router-cli": "^1.166.18",
     "@tanstack/router-plugin": "^1.167.4",
     "@testing-library/react": "^16.3.2",

package.json

@@ -1,4 +1,5 @@
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { ReactQueryDevtools } from '@tanstack/react-query-devtools';
 import { type ReactNode, useState } from 'react';
 
 export function AppQueryProvider({ children }: { children: ReactNode }) {
@@ -9,10 +10,20 @@ export function AppQueryProvider({ children }: { children: ReactNode }) {
           queries: {
             refetchOnWindowFocus: false,
             staleTime: 5 * 60 * 1000,
+            gcTime: 10 * 60 * 1000,
+            retry: 1,
+          },
+          mutations: {
+            retry: 0,
           },
         },
       })
   );
 
-  return <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>;
+  return (
+    <QueryClientProvider client={queryClient}>
+      {children}
+      <ReactQueryDevtools initialIsOpen={false} position="bottom" />
+    </QueryClientProvider>
+  );
 }

pnpm-lock.yaml

@@ -0,0 +1,43 @@
+import {
+  CircleCheckIcon,
+  InfoIcon,
+  Loader2Icon,
+  OctagonXIcon,
+  TriangleAlertIcon,
+} from 'lucide-react';
+import { useTheme } from 'next-themes';
+import { Toaster as Sonner, type ToasterProps } from 'sonner';
+
+const Toaster = ({ ...props }: ToasterProps) => {
+  const { theme = 'system' } = useTheme();
+
+  return (
+    <Sonner
+      theme={theme === 'dark' || theme === 'light' || theme === 'system' ? theme : 'system'}
+      className="toaster group"
+      icons={{
+        success: <CircleCheckIcon className="size-4" />,
+        info: <InfoIcon className="size-4" />,
+        warning: <TriangleAlertIcon className="size-4" />,
+        error: <OctagonXIcon className="size-4" />,
+        loading: <Loader2Icon className="size-4 animate-spin" />,
+      }}
+      style={
+        {
+          '--normal-bg': 'var(--popover)',
+          '--normal-text': 'var(--popover-foreground)',
+          '--normal-border': 'var(--border)',
+          '--border-radius': 'var(--radius)',
+        } as React.CSSProperties
+      }
+      toastOptions={{
+        classNames: {
+          toast: 'cn-toast',
+        },
+      }}
+      {...props}
+    />
+  );
+};
+
+export { Toaster };