chore: ESLint Fixes and Tailwind CSS Integration Improvements (#968)

# ESLint Fixes and Tailwind CSS Integration Improvements

## Changes Made

### ESLint Fixes
- Re-enabled and fixed all `@typescript-eslint/no-use-before-define`
rule violations
- Fixed code structure in multiple files to properly declare variables
and functions before use:
-
[BaseSprintfPlaceholderConversions.tsx](cci:7://file:///Users/home/Developer/documentation/src/component/docs/formats/BaseSprintfPlaceholderConversions.tsx:0:0-0:0)
-
[getSpecData.ts](cci:7://file:///Users/home/Developer/documentation/apiSpecGeneration/scripts/getSpecData.ts:0:0-0:0)
-
[plausible.ts](cci:7://file:///Users/home/Developer/documentation/src/component/externalScripts/plausible.ts:0:0-0:0)
- Added proper TypeScript types for variables where needed
- Removed duplicate React imports

### Tailwind CSS Integration
- Implemented modular plugin approach for better Docusaurus v3
compatibility
- Created dedicated
[plugins/tailwind-config.cjs](cci:7://file:///Users/home/Developer/documentation/plugins/tailwind-config.cjs:0:0-0:0)
for PostCSS configuration
- Updated Tailwind CSS to v3.4.1 from v3.1.4 for latest features and
improvements
- Fixed CSS import order in
[custom.css](cci:7://file:///Users/home/Developer/documentation/src/css/custom.css:0:0-0:0)
to resolve PostCSS warnings
- Added `postcss-import` dependency for better CSS processing

### Dependency Management
- Updated PostCSS to v8.4.31 to resolve dependency warnings
- Removed unused dependencies to reduce conflicts and simplify
maintenance

## Testing
- Verified successful builds with no ESLint errors
- Confirmed Tailwind CSS styles are properly applied
- Tested dark mode compatibility

## Technical Details
The PR follows the official Docusaurus v3 + Tailwind CSS integration
best practices, replacing the previous inline plugin approach with a
more maintainable modular structure. The updated configuration properly
handles dark mode with Docusaurus v3's theming system.

Author: dzienisz

.eslintignore

@@ -0,0 +1,3 @@
+node_modules
+build
+.docusaurus

.eslintrc.json

@@ -11,7 +11,8 @@
   "extends": [
     "eslint:recommended",
     "plugin:react/recommended",
-    "plugin:@typescript-eslint/recommended"
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@docusaurus/recommended"
   ],
   "parser": "@typescript-eslint/parser",
   "parserOptions": {

.npmrc

@@ -1 +1 @@
-legacy-peer-deps=true
+legacy-peer-deps=true

apiSpecGeneration/scripts/getSpecData.ts

@@ -1,11 +1,21 @@
 import fs from 'fs';
 
+export const possibleExtensions = ['ee', 'cloud', 'self-hosted'] as const;
+type Extension = (typeof possibleExtensions)[number];
+
+function convertCamelToKebab(string: string) {
+  return string
+    .replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, '$1-$2')
+    .replace('_', '-')
+    .toLowerCase();
+}
+
 export function getData() {
   const json = fs.readFileSync(__dirname + '/../apiSpecs.json').toString();
   const apis = JSON.parse(json);
 
-  const tags = {};
-  const operations = {};
+  const tags: Record<string, number> = {};
+  const operations: Record<string, number> = {};
   const extensions: Record<string, Extension[]> = {};
 
   for (const path in apis.paths) {
@@ -31,13 +41,3 @@ export function getData() {
   }
   return { tags, operations, extensions };
 }
-
-export const possibleExtensions = ['ee', 'cloud', 'self-hosted'] as const;
-type Extension = (typeof possibleExtensions)[number];
-
-function convertCamelToKebab(string) {
-  return string
-    .replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, '$1-$2')
-    .replace('_', '-')
-    .toLowerCase();
-}

babel.config.js

@@ -1,3 +1,3 @@
 export default {
   presets: ['@docusaurus/babel/preset'],
-};
+};

docusaurus.config.ts

@@ -7,6 +7,7 @@ import { navbar } from './navbar';
 import { footer } from './footer';
 import type { Config } from '@docusaurus/types';
 import openApiPluginConfig from './apiSpecGeneration/pluginConfig';
+import tailwindPlugin from './plugins/tailwind-config.cjs';
 
 const config: Config = {
   title: 'Tolgee',
@@ -72,21 +73,9 @@ const config: Config = {
   plugins: [
     'docusaurus-plugin-image-zoom',
     ['@docusaurus/plugin-client-redirects', redirects],
-    '@signalwire/docusaurus-plugin-llms-txt',
-    async function tailwind() {
-      return {
-        name: 'docusaurus-tailwindcss',
-        configurePostCss(postcssOptions) {
-          postcssOptions.plugins = [
-            require('tailwindcss'),
-            require('autoprefixer'),
-          ];
-          return postcssOptions;
-        },
-      };
-    },
     openApiPluginConfig,
     ...docs,
+    tailwindPlugin,
   ],
   customFields: {
     googleTrackingId: process.env.DOCUSAURUS_GOOGLE_TRACKING_ID,