tsconfig.json

{
	"extends": "astro/tsconfigs/strict", // Base config for strict type checking in Astro
	"compilerOptions": {
		"verbatimModuleSyntax": false, // Simplifies import/export handling
		"types": ["astro/client", "jest"],
		"baseUrl": ".", // Enables absolute imports
		"paths": {
			// Core aliases
			"@/*": ["src/*"],
			"@core/*": ["src/core/*"],
			"@config/*": ["src/core/config/*"],
			"@customTypes/*": ["src/core/types/*"],
			"@interfaces/*": ["src/core/interfaces/*"],
			"@utilities/*": ["src/core/utilities/*"],
			"@helpers/*": ["src/core/helpers/*"],
			"@data/*": ["src/core/data/*"],

			// Frontend aliases
			"@frontend/*": ["src/frontend/*"],
			"@components/*": ["src/frontend/components/*"],
			"@layouts/*": ["src/frontend/layouts/*"],
			"@hooks/*": ["src/frontend/hooks/*"],
			"@styles/*": ["src/frontend/styles/*"],
			"@assets/*": ["src/frontend/assets/*"],
			"@images/*": ["src/frontend/assets/images/*"],
			"@icons/*": ["src/frontend/assets/icons/*"],
			"@fonts/*": ["src/frontend/assets/fonts/*"],

			// Backend aliases
			"@backend/*": ["src/backend/*"],
			"@api/*": ["src/pages/api/*"],
			"@services/*": ["src/backend/services/*"],
			"@controllers/*": ["src/backend/controllers/*"],
			"@repositories/*": ["src/backend/repositories/*"],
			"@middlewares/*": ["src/backend/middlewares/*"],
			"@models/*": ["src/backend/models/*"],
			"@db/*": ["src/backend/database/*"]
		},
		"jsx": "react-jsx", // Enables React JSX support
		"jsxImportSource": "react", // Configures React for JSX transform
		"lib": ["dom", "dom.iterable", "esnext"], // Latest DOM and ES features
		"module": "ESNext", // Uses ES Modules
		"moduleResolution": "node", // Resolves modules like Node.js
		"allowSyntheticDefaultImports": true, // Allows default imports for compatibility
		"experimentalDecorators": true, // Enables experimental decorator syntax
		"emitDecoratorMetadata": true, // Emits metadata for decorators
		"skipLibCheck": true // Improves performance by skipping type checking for libraries
	},
	"include": ["src", "astro/types.d.ts", "env.d.ts"], // Includes source and type definitions
	"exclude": ["node_modules", "dist"] // Excludes dependencies and build outputs
}