@vijayhardaha/dev-config 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Vijay Hardaha
+
+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.

package/README.md

@@ -0,0 +1,86 @@
+# @vijayhardaha/dev-config
+
+Reusable development configuration package for Next.js + TypeScript projects.
+
+## Features
+
+- **ESLint** - Modular flat config with support for JavaScript, TypeScript, React, and Next.js
+- **Prettier** - Consistent code formatting with language-specific rules
+- **Commitlint** - Enforces conventional commit messages
+- **TypeScript** - Base configuration for type checking
+- **JSConfig** - IntelliSense support for JavaScript projects
+- **Stylelint** - CSS/SCSS linting configuration
+- **Next Sitemap** - Sitemap generation configuration
+
+## Installation
+
+```bash
+npm install @vijayhardaha/dev-config --save-dev
+```
+
+## Quick Start
+
+### ESLint
+
+Create `eslint.config.mjs` in your project root:
+
+```javascript
+import { createConfig } from "@vijayhardaha/dev-config/eslint/next";
+
+export default createConfig();
+```
+
+### Prettier
+
+Create `prettier.config.mjs` in your project root:
+
+```javascript
+import prettierConfig from "@vijayhardaha/dev-config/prettier";
+
+export default prettierConfig;
+```
+
+### Commitlint
+
+Create `commitlint.config.mjs` in your project root:
+
+```javascript
+import commitlintConfig from "@vijayhardaha/dev-config/commitlint";
+
+export default commitlintConfig;
+```
+
+## Configuration Options
+
+### ESLint
+
+```javascript
+import { createConfig } from "@vijayhardaha/dev-config/eslint/next";
+
+export default createConfig({
+  prettier: true, // Enable Prettier integration
+  importOrder: true, // Enable import ordering
+  react: true, // Enable React rules
+  a11y: true // Enable accessibility rules
+});
+```
+
+Available configs:
+
+- `@vijayhardaha/dev-config/eslint` - JavaScript
+- `@vijayhardaha/dev-config/eslint/ts` - TypeScript
+- `@vijayhardaha/dev-config/eslint/react` - React + TypeScript
+- `@vijayhardaha/dev-config/eslint/next` - Next.js + React + TypeScript
+
+## Scripts
+
+| Command                | Description            |
+| ---------------------- | ---------------------- |
+| `npm run lint`         | Run ESLint             |
+| `npm run lint:fix`     | Auto-fix ESLint issues |
+| `npm run format`       | Format with Prettier   |
+| `npm run format:check` | Check formatting       |
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@vijayhardaha/dev-config",
+  "version": "1.0.0",
+  "description": "Reusable development configurations for Next.js + TypeScript projects",
+  "author": "Vijay Hardaha",
+  "license": "MIT",
+  "type": "module",
+  "main": "./src/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vijayhardaha/dev-config.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vijayhardaha/dev-config/issues"
+  },
+  "homepage": "https://github.com/vijayhardaha/dev-config#readme",
+  "exports": {
+    ".": "./src/index.js",
+    "./eslint": "./src/eslint/index.js",
+    "./eslint/ts": "./src/eslint/ts.js",
+    "./eslint/react": "./src/eslint/react.js",
+    "./eslint/next": "./src/eslint/next.js",
+    "./prettier": "./src/prettier/index.js",
+    "./commitlint": "./src/commitlint/index.js",
+    "./stylelint": "./src/stylelint/index.js",
+    "./next-sitemap": "./src/next-sitemap/index.js",
+    "./typescript/base": "./src/typescript/base.json",
+    "./typescript/tsconfig": "./src/typescript/tsconfig.json",
+    "./jsconfig": "./src/jsconfig/index.json"
+  },
+  "files": [
+    "src",
+    "LICENSE"
+  ],
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "release": "release-it",
+    "release:dry": "release-it --dry-run",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "config",
+    "devtools",
+    "eslint",
+    "prettier",
+    "commitlint",
+    "stylelint",
+    "next-sitemap",
+    "typescript"
+  ],
+  "peerDependencies": {
+    "@commitlint/cli": "^20",
+    "@commitlint/config-conventional": "^20",
+    "@eslint/compat": "^2",
+    "@eslint/eslintrc": "^3",
+    "@eslint/js": "^9",
+    "@next/eslint-plugin-next": "^15",
+    "@typescript-eslint/eslint-plugin": "^8",
+    "@typescript-eslint/parser": "^8",
+    "eslint": "^9",
+    "eslint-config-next": "^15",
+    "eslint-config-prettier": "^10",
+    "eslint-plugin-import": "^2",
+    "eslint-plugin-jsx-a11y": "^6",
+    "eslint-plugin-prettier": "^5",
+    "eslint-plugin-react": "^7",
+    "eslint-plugin-react-hooks": "^7",
+    "globals": "^17",
+    "prettier": "^3",
+    "stylelint": "^17",
+    "stylelint-config-property-sort-order-smacss": "^11",
+    "stylelint-config-standard-scss": "^17",
+    "stylelint-order": "^8",
+    "typescript": "^5"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@eslint/compat": "^2.0.3",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^9.39.4",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "globals": "^17.4.0",
+    "husky": "^9.1.7",
+    "prettier": "^3.8.1",
+    "release-it": "^19.2.4"
+  }
+}

package/src/commitlint/index.js

@@ -0,0 +1,31 @@
+/**
+ * =====================================================================
+ * Commitlint Configuration
+ * =====================================================================
+ * Purpose: Enforce conventional commit message standards for consistent
+ *          and meaningful Git commit history.
+ * Docs: https://commitlint.js.org/#/
+ * =====================================================================
+ */
+
+/** @type {import('@commitlint/types').UserConfig} */
+const config = {
+  // ---- Extends ----
+  // Use conventional commit rules as the base configuration
+  extends: ['@commitlint/config-conventional'],
+
+  // ---- Rules ----
+  // Maximum length for the commit header (first line)
+  'header-max-length': [2, 'always', 50],
+
+  // Maximum length for any line in the commit body
+  'body-max-line-length': [2, 'always', 72],
+
+  // Commit body must be in sentence case or lower case
+  'body-case': [2, 'always', ['sentence-case', 'lower-case']],
+
+  // Subject case is not enforced (allows flexibility)
+  'subject-case': [0],
+};
+
+export default config;

package/src/eslint/common.js

@@ -0,0 +1,145 @@
+/**
+ * =====================================================================
+ * Eslint Common Configuration
+ * =====================================================================
+ * Purpose: Shared setup for all ESLint configurations including common
+ *          ignores, parser setup, and rule definitions.
+ * Docs: https://eslint.org/docs/latest/use/configure/configuration-files-new
+ * =====================================================================
+ */
+
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { FlatCompat } from '@eslint/eslintrc';
+import js from '@eslint/js';
+import tsParser from '@typescript-eslint/parser';
+import { globalIgnores } from 'eslint/config';
+import globals from 'globals';
+
+/**
+ * Global ignore patterns for ESLint to skip build artifacts, dependencies,
+ * and generated files during linting.
+ */
+export const ignores = [
+  '**/.git/',
+  '**/.idea/',
+  '**/.vscode/',
+  '**/.husky/',
+  '**/node_modules/',
+  '**/.next/',
+  '**/dist/',
+  '**/build/',
+  '**/out/',
+  '**/.vercel/',
+  '**/.cache/',
+  '**/.turbo/',
+  '**/*.tsbuildinfo',
+  '**/coverage/',
+  '**/test-results/',
+  '**/.playwright-report/',
+  '**/public/',
+  '**/.env*',
+  '**/next-env.d.ts',
+  '**/*.log',
+  '**/.DS_Store',
+  '**/Thumbs.db',
+  '**/*.tmp',
+];
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Creates a FlatCompat instance for using flat config format with older
+ * ESLint configurations.
+ */
+const compat = new FlatCompat({ baseDirectory: __dirname, recommendedConfig: js.configs.recommended });
+
+/**
+ * Returns the setup object containing shared utilities for ESLint configs.
+ * @returns {{ compat: FlatCompat, tsParser: typeof tsParser, __dirname: string }}
+ */
+export const setup = () => ({ compat, tsParser, __dirname });
+
+/**
+ * Global ignores configuration using ESLint's globalIgnores helper.
+ * @type {import('eslint').Linter.Config}
+ */
+export const commonIgnores = [globalIgnores(ignores)];
+
+/**
+ * Common parser configuration for TypeScript files.
+ * @type {{ parser: typeof tsParser }}
+ */
+export const commonParser = { parser: tsParser };
+
+/**
+ * Common language options for ESLint including ECMAScript version,
+ * source type, and global variables.
+ * @type {import('eslint').Linter.LanguageOptions}
+ */
+export const commonLanguageOptions = {
+  ecmaVersion: 'latest',
+  sourceType: 'module',
+  globals: { ...globals.browser, ...globals.node },
+};
+
+/**
+ * Creates a rules object based on the provided options.
+ * @param {Object} [options] - Configuration options
+ * @param {boolean} [options.typescript=true] - Enable TypeScript-specific rules
+ * @param {boolean} [options.importOrder=true] - Enable import order rules
+ * @param {boolean} [options.prettier=true] - Enable Prettier integration
+ * @returns {Object} ESLint rules object
+ */
+export const commonRules = (options = {}) => {
+  const { typescript = true, importOrder = true, prettier = true } = options;
+
+  return {
+    // ---- TypeScript Rules ----
+    // Report unused variables with TypeScript-aware analysis
+    ...(typescript && {
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          vars: 'all',
+          args: 'after-used',
+          varsIgnorePattern: '^_',
+          argsIgnorePattern: '^_',
+          ignoreRestSiblings: true,
+          caughtErrors: 'all',
+        },
+      ],
+    }),
+
+    // ---- Import Order Rules ----
+    // Enforce consistent import ordering with specific group priorities
+    ...(importOrder && {
+      'import/order': [
+        'error',
+        {
+          groups: ['builtin', 'external', 'internal', ['parent', 'sibling'], 'index', 'object'],
+          pathGroups: [
+            { pattern: 'react', group: 'external', position: 'before' },
+            { pattern: '@/**', group: 'internal', position: 'after' },
+          ],
+          pathGroupsExcludedImportTypes: ['react'],
+          alphabetize: { order: 'asc', caseInsensitive: true },
+          'newlines-between': 'always',
+          warnOnUnassignedImports: true,
+        },
+      ],
+    }),
+
+    // ---- Prettier Integration ----
+    // Report Prettier formatting issues as warnings
+    ...(prettier && { 'prettier/prettier': 'warn' }),
+  };
+};
+
+/**
+ * File patterns for ESLint configuration.
+ * @type {{ withTs: string[], withoutTs: string[] }}
+ */
+export const files = { withTs: ['**/*.{js,jsx,mjs,cjs,ts,tsx}'], withoutTs: ['**/*.{js,jsx,mjs,cjs}'] };

package/src/eslint/index.js

@@ -0,0 +1,70 @@
+/**
+ * =====================================================================
+ * Eslint Configuration (Flat)
+ * =====================================================================
+ * Purpose: Project-wide ESLint configuration for JavaScript.
+ *          Enforces code quality and consistent styling.
+ * Docs: https://eslint.org/docs/latest/use/configure/configuration-files-new
+ * Usage: npx eslint .
+ * =====================================================================
+ */
+
+import { defineConfig } from 'eslint/config';
+
+import { setup, commonIgnores, commonRules, commonLanguageOptions, files } from './common.js';
+
+const { compat } = setup();
+
+/**
+ * Creates an ESLint configuration object with optional features.
+ * @param {Object} [options] - Configuration options
+ * @param {boolean} [options.prettier=true] - Enable Prettier integration
+ * @param {boolean} [options.importOrder=true] - Enable import order rules
+ * @returns {import('eslint').Linter.Config[]} ESLint configuration array
+ */
+export const createConfig = (options = {}) => {
+  const { prettier = true, importOrder = true } = options;
+
+  // ---- Extends Configs ----
+  // Build the extends array based on enabled features
+  const extendsConfigs = [importOrder && 'plugin:import/recommended', prettier && 'plugin:prettier/recommended'].filter(
+    Boolean
+  );
+
+  return defineConfig([
+    // ---- Global Ignores ----
+    ...commonIgnores,
+
+    // ---- Extends Configs ----
+    ...compat.extends(...extendsConfigs),
+
+    {
+      // ---- JavaScript Files Configuration ----
+      // Apply to JavaScript files without TypeScript
+      files: files.withoutTs,
+
+      languageOptions: commonLanguageOptions,
+
+      rules: {
+        // ---- Unused Variables Rule ----
+        // Report unused variables for JavaScript files
+        'no-unused-vars': [
+          'error',
+          {
+            vars: 'all',
+            args: 'after-used',
+            varsIgnorePattern: '^_',
+            argsIgnorePattern: '^_',
+            ignoreRestSiblings: true,
+            caughtErrors: 'all',
+          },
+        ],
+        // ---- Common Rules ----
+        // Apply shared rules based on options
+        ...commonRules({ prettier, importOrder, typescript: false }),
+      },
+    },
+  ]);
+};
+
+export default createConfig();

package/src/eslint/next.js

@@ -0,0 +1,81 @@
+/**
+ * =====================================================================
+ * Eslint Configuration (Flat)
+ * =====================================================================
+ * Purpose: Project-wide ESLint configuration for Next.js, TypeScript, and
+ *          React. Enforces code quality, accessibility, and consistent styling.
+ * Docs: https://eslint.org/docs/latest/use/configure/configuration-files-new
+ * Usage: npx eslint .
+ * =====================================================================
+ */
+
+import { defineConfig } from 'eslint/config';
+
+import { setup, commonIgnores, commonParser, commonRules, commonLanguageOptions, files } from './common.js';
+
+const { compat, __dirname } = setup();
+
+/**
+ * Creates an ESLint configuration object for Next.js projects with TypeScript
+ * and React support.
+ * @param {Object} [options] - Configuration options
+ * @param {boolean} [options.prettier=true] - Enable Prettier integration
+ * @param {boolean} [options.react=true] - Enable React-specific rules
+ * @param {boolean} [options.a11y=true] - Enable accessibility rules
+ * @param {boolean} [options.importOrder=true] - Enable import order rules
+ * @returns {import('eslint').Linter.Config[]} ESLint configuration array
+ */
+export const createConfig = (options = {}) => {
+  const { prettier = true, react = true, a11y = true, importOrder = true } = options;
+
+  // ---- Extends Configs ----
+  // Build the extends array based on enabled features
+  const extendsConfigs = [
+    'plugin:import/recommended',
+    'next/core-web-vitals',
+    'next/typescript',
+    react && 'plugin:react/recommended',
+    react && 'plugin:react-hooks/recommended',
+    a11y && 'plugin:jsx-a11y/recommended',
+    'plugin:@typescript-eslint/recommended',
+    prettier && 'plugin:prettier/recommended',
+  ].filter(Boolean);
+
+  return defineConfig([
+    // ---- Global Ignores ----
+    ...commonIgnores,
+
+    // ---- Extends Configs ----
+    ...compat.extends(...extendsConfigs),
+
+    {
+      // ---- TypeScript Files Configuration ----
+      // Apply to TypeScript files
+      files: files.withTs,
+
+      languageOptions: {
+        ...commonLanguageOptions,
+        ...commonParser,
+        // ---- Parser Options ----
+        // Configure TypeScript parser with React JSX support
+        parserOptions: { ecmaFeatures: { jsx: true }, tsconfigRootDir: __dirname },
+      },
+
+      // ---- React Settings ----
+      ...(react && { settings: { react: { version: 'detect' } } }),
+
+      rules: {
+        // ---- React Rules ----
+        // Disable React import requirement (Next.js handles this)
+        ...(react && { 'react/react-in-jsx-scope': 'off' }),
+        // Allow JSX and global attributes
+        ...(react && { 'react/no-unknown-property': ['error', { ignore: ['jsx', 'global'] }] }),
+        // ---- Common Rules ----
+        // Apply shared rules
+        ...commonRules({ prettier, importOrder }),
+      },
+    },
+  ]);
+};
+
+export default createConfig();

package/src/eslint/react.js

@@ -0,0 +1,78 @@
+/**
+ * =====================================================================
+ * Eslint Configuration (Flat)
+ * =====================================================================
+ * Purpose: Project-wide ESLint configuration for React with TypeScript.
+ *          Enforces code quality, accessibility, and consistent styling.
+ * Docs: https://eslint.org/docs/latest/use/configure/configuration-files-new
+ * Usage: npx eslint .
+ * =====================================================================
+ */
+
+import { defineConfig } from 'eslint/config';
+
+import { setup, commonIgnores, commonParser, commonRules, commonLanguageOptions, files } from './common.js';
+
+const { compat, __dirname } = setup();
+
+/**
+ * Creates an ESLint configuration object for React projects with TypeScript
+ * support.
+ * @param {Object} [options] - Configuration options
+ * @param {boolean} [options.prettier=true] - Enable Prettier integration
+ * @param {boolean} [options.a11y=true] - Enable accessibility rules
+ * @param {boolean} [options.importOrder=true] - Enable import order rules
+ * @returns {import('eslint').Linter.Config[]} ESLint configuration array
+ */
+export const createConfig = (options = {}) => {
+  const { prettier = true, a11y = true, importOrder = true } = options;
+
+  // ---- Extends Configs ----
+  // Build the extends array based on enabled features
+  const extendsConfigs = [
+    'plugin:import/recommended',
+    'plugin:react/recommended',
+    'plugin:react-hooks/recommended',
+    a11y && 'plugin:jsx-a11y/recommended',
+    'plugin:@typescript-eslint/recommended',
+    prettier && 'plugin:prettier/recommended',
+  ].filter(Boolean);
+
+  return defineConfig([
+    // ---- Global Ignores ----
+    ...commonIgnores,
+
+    // ---- Extends Configs ----
+    ...compat.extends(...extendsConfigs),
+
+    {
+      // ---- TypeScript Files Configuration ----
+      // Apply to TypeScript files
+      files: files.withTs,
+
+      languageOptions: {
+        ...commonLanguageOptions,
+        ...commonParser,
+        // ---- Parser Options ----
+        // Configure TypeScript parser with React JSX support
+        parserOptions: { ecmaFeatures: { jsx: true }, tsconfigRootDir: __dirname },
+      },
+
+      // ---- React Settings ----
+      settings: { react: { version: 'detect' } },
+
+      rules: {
+        // ---- React Rules ----
+        // Disable React import requirement (Next.js handles this)
+        'react/react-in-jsx-scope': 'off',
+        // Allow JSX and global attributes
+        'react/no-unknown-property': ['error', { ignore: ['jsx', 'global'] }],
+        // ---- Common Rules ----
+        // Apply shared rules
+        ...commonRules({ prettier, importOrder }),
+      },
+    },
+  ]);
+};
+
+export default createConfig();

package/src/eslint/typescript.js

@@ -0,0 +1,61 @@
+/**
+ * =====================================================================
+ * Eslint Configuration (Flat)
+ * =====================================================================
+ * Purpose: Project-wide ESLint configuration for TypeScript.
+ *          Enforces code quality and consistent styling.
+ * Docs: https://eslint.org/docs/latest/use/configure/configuration-files-new
+ * Usage: npx eslint .
+ * =====================================================================
+ */
+
+import { defineConfig } from 'eslint/config';
+
+import { setup, commonIgnores, commonParser, commonRules, commonLanguageOptions, files } from './common.js';
+
+const { compat, __dirname } = setup();
+
+/**
+ * Creates an ESLint configuration object for TypeScript projects.
+ * @param {Object} [options] - Configuration options
+ * @param {boolean} [options.prettier=true] - Enable Prettier integration
+ * @param {boolean} [options.importOrder=true] - Enable import order rules
+ * @returns {import('eslint').Linter.Config[]} ESLint configuration array
+ */
+export const createConfig = (options = {}) => {
+  const { prettier = true, importOrder = true } = options;
+
+  // ---- Extends Configs ----
+  // Build the extends array based on enabled features
+  const extendsConfigs = [
+    'plugin:@typescript-eslint/recommended',
+    importOrder && 'plugin:import/recommended',
+    prettier && 'plugin:prettier/recommended',
+  ].filter(Boolean);
+
+  return defineConfig([
+    // ---- Global Ignores ----
+    ...commonIgnores,
+
+    // ---- Extends Configs ----
+    ...compat.extends(...extendsConfigs),
+
+    {
+      // ---- TypeScript Files Configuration ----
+      // Apply to TypeScript files
+      files: files.withTs,
+
+      languageOptions: {
+        ...commonLanguageOptions,
+        ...commonParser,
+        // ---- Parser Options ----
+        // Configure TypeScript parser
+        parserOptions: { tsconfigRootDir: __dirname },
+      },
+
+      rules: commonRules({ prettier, importOrder }),
+    },
+  ]);
+};
+
+export default createConfig();

package/src/index.js

@@ -0,0 +1,63 @@
+/**
+ * =====================================================================
+ * Dev Configurations Index
+ * =====================================================================
+ * Purpose: Central index file that re-exports all configuration presets
+ *          for easy consumption by root-level config files.
+ * Docs: https://github.com/vijay/repositories/projects/dev-config
+ * =====================================================================
+ */
+
+/**
+ * ESLint configuration for JavaScript files.
+ * @type {import('eslint').Linter.Config}
+ */
+export { default as eslint, createConfig as createEslintConfig } from './eslint/index.js';
+
+/**
+ * ESLint configuration for TypeScript files.
+ * @type {import('eslint').Linter.Config}
+ */
+export { default as eslintTs, createConfig as createEslintTsConfig } from './eslint/typescript.js';
+
+/**
+ * ESLint configuration for React files.
+ * @type {import('eslint').Linter.Config}
+ */
+export { default as eslintReact, createConfig as createEslintReactConfig } from './eslint/react.js';
+
+/**
+ * ESLint configuration for Next.js files.
+ * @type {import('eslint').Linter.Config}
+ */
+export { default as eslintNext, createConfig as createEslintNextConfig } from './eslint/next.js';
+
+/**
+ * Prettier configuration.
+ * @type {import('prettier').Config}
+ */
+export { default as prettier } from './prettier/index.js';
+
+/**
+ * Commitlint configuration.
+ * @type {import('@commitlint/types').UserConfig}
+ */
+export { default as commitlint } from './commitlint/index.js';
+
+/**
+ * Next.js sitemap configuration.
+ * @type {import('next-sitemap').IConfig}
+ */
+export { default as nextSitemap, createSitemapConfig } from './next-sitemap/index.js';
+
+/**
+ * Stylelint configuration.
+ * @type {import('stylelint').Config}
+ */
+export { default as stylelint } from './stylelint/index.js';
+
+/**
+ * TypeScript base configuration.
+ * @type {import('typescript').CompilerOptions}
+ */
+export { default as typescriptBase } from './typescript/base.json';

package/src/jsconfig/index.json

@@ -0,0 +1,24 @@
+// =====================================================================
+// JavaScript Configuration
+// =====================================================================
+// Purpose: JavaScript configuration for module resolution and path mapping.
+// Docs: https://github.com/microsoft/TypeScript/wiki/Using-the-Compiler#jsconfigjson
+// =====================================================================
+
+{
+  // ---- Compiler Options ----
+  // Use React's modern JSX transform for better performance
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    // Allow importing JSON modules
+    "resolveJsonModule": true,
+    // Base directory for non-relative imports
+    "baseUrl": ".",
+    // Map @/* to ./src/* for cleaner imports
+    "paths": { "@/*": ["./src/*"] }
+  },
+
+  // ---- Excluded Files ----
+  // Skip directories that don't need type checking
+  "exclude": ["node_modules", ".next", "out"]
+}

package/src/next-sitemap/index.js

@@ -0,0 +1,58 @@
+/**
+ * =====================================================================
+ * Next Sitemap Configuration
+ * =====================================================================
+ * Purpose: Next.js sitemap configuration for generating SEO-friendly
+ *          sitemaps with robots.txt support.
+ * Docs: https://github.com/iamvishnusankar/next-sitemap
+ * =====================================================================
+ */
+
+/**
+ * Creates a sitemap configuration object for next-sitemap.
+ * @param {Object} [options] - Configuration options
+ * @param {string} [options.siteUrl='https://example.com'] - Site base URL
+ * @param {string} [options.outDir='./public'] - Output directory for sitemap files
+ * @param {string[]} [options.exclude=['/404', '/500']] - Paths to exclude from sitemap
+ * @returns {import('next-sitemap').IConfig} Sitemap configuration object
+ */
+export function createSitemapConfig(options = {}) {
+  const { siteUrl = 'https://example.com', outDir = './public', exclude = ['/404', '/500'] } = options;
+
+  // ---- Last Modified ----
+  // Use current timestamp for all sitemap entries
+  const lastModified = new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+
+  return {
+    // ---- Basic Settings ----
+    siteUrl,
+    sitemapBaseFileName: 'sitemap',
+    trailingSlash: false,
+
+    // ---- Output Settings ----
+    outDir,
+    changefreq: 'weekly',
+    priority: 0.7,
+    exclude,
+
+    // ---- Transform Function ----
+    // Add last modified timestamp to each entry
+    transform: (_config, path) => {
+      return { loc: path, changefreq: _config.changefreq, priority: _config.priority, lastmod: lastModified };
+    },
+
+    // ---- Robots.txt Generation ----
+    generateRobotsTxt: true,
+    robotsTxtOptions: {
+      policies: [{ userAgent: '*', allow: '/' }],
+      // ---- Custom Robots.txt Transform ----
+      // Remove the default Host header from generated robots.txt
+      transformRobotsTxt: async (_config, robotsTxt) => {
+        const hostHeader = `# Host\nHost: ${siteUrl}\n\n`;
+        return robotsTxt.replace(hostHeader, '');
+      },
+    },
+  };
+}
+
+export default createSitemapConfig();

package/src/prettier/index.js

@@ -0,0 +1,66 @@
+/**
+ * =====================================================================
+ * Prettier Configuration
+ * =====================================================================
+ * Purpose: Code formatting configuration for consistent style across
+ *          the project.
+ * Docs: https://prettier.io/docs/en/configuration.html
+ * Usage: npx prettier --write .
+ * =====================================================================
+ */
+
+/** @type {import("prettier").Config} */
+const config = {
+  // ---- Basic Settings ----
+  // Maximum line width before wrapping
+  printWidth: 120,
+  // Number of spaces per indentation
+  tabWidth: 2,
+  // Use spaces instead of tabs
+  useTabs: false,
+  // Add semicolons at the end of statements
+  semi: true,
+  // Use single quotes for strings
+  singleQuote: false,
+  // Handle line endings automatically
+  endOfLine: 'auto',
+  // Always include parentheses around arrow function parameters
+  arrowParens: 'always',
+  // Trailing commas in multi-line structures
+  trailingComma: 'es5',
+  // Add spaces between object braces
+  bracketSpacing: true,
+  // Do not put single-line objects on a single line
+  bracketSameLine: false,
+  // Preserve prose wrapping in Markdown files
+  proseWrap: 'preserve',
+  // Experimental operator position at start
+  experimentalOperatorPosition: 'start',
+  // Collapse object literals
+  objectWrap: 'collapse',
+
+  // ---- Overrides ----
+  // Different formatting rules for different file types
+  overrides: [
+    // ---- Backend Languages ----
+    // Use 4-space indentation for Python and PHP
+    { files: ['*.py', '*.php'], options: { tabWidth: 4, useTabs: false } },
+
+    // ---- JavaScript/TypeScript ----
+    // Use 2-space indentation and single quotes for JS/TS
+    { files: ['*.js', '*.ts', '*.mjs', '*.cjs', '*.jsx', '*.tsx'], options: { tabWidth: 2, singleQuote: true } },
+
+    // ---- Stylesheet Languages ----
+    // Use 2-space indentation for CSS/SCSS/SASS
+    { files: ['*.css', '*.scss', '*.sass'], options: { tabWidth: 2 } },
+
+    // ---- Data & Documentation ----
+    // Use 2-space indentation and no trailing commas for JSON/YAML/Markdown
+    {
+      files: ['*.json', '*.jsonc', '*.yml', '*.yaml', '*.md', '*.mdx'],
+      options: { tabWidth: 2, trailingComma: 'none' },
+    },
+  ],
+};
+
+export default config;

package/src/stylelint/index.js

@@ -0,0 +1,35 @@
+/**
+ * =====================================================================
+ * Stylelint Configuration
+ * =====================================================================
+ * Purpose: CSS/SCSS linting configuration for consistent styling and
+ *          proper property ordering.
+ * Docs: https://stylelint.io/user-guide/configure
+ * Usage: npx stylelint .
+ * =====================================================================
+ */
+
+/** @type {import("stylelint").Config} */
+const config = {
+  // ---- Extends ----
+  // Use standard SCSS configuration and property sort order
+  extends: ['stylelint-config-standard-scss', 'stylelint-config-property-sort-order-smacss'],
+
+  // ---- Plugins ----
+  // Use stylelint-order for property sorting
+  plugins: ['stylelint-order'],
+
+  // ---- Rules ----
+  // Disable specific rules that are too strict or conflict with team style
+  rules: {
+    'selector-class-pattern': null,
+    'selector-id-pattern': null,
+    'no-empty-source': null,
+    'function-url-quotes': null,
+    'no-descending-specificity': null,
+    'comment-no-empty': null,
+    'scss/comment-no-empty': null,
+  },
+};
+
+export default config;

package/src/typescript/base.json

@@ -0,0 +1,42 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "lib": ["ES2024", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "paths": { "@/*": ["./src/*"] },
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "verbatimModuleSyntax": true,
+    "incremental": true,
+    "noEmit": true,
+    "isolatedModules": true,
+    "allowJs": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "useDefineForClassFields": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    ".next/dev/types/**/*.ts",
+    ".next/types/**/*.ts",
+    "*.config.mjs",
+    "*.config.ts",
+    "*.d.ts",
+    "**/*.js",
+    "**/*.jsx",
+    "**/*.ts",
+    "**/*.tsx",
+    "**/*.mjs",
+    "**/*.cjs",
+    "next-env.d.ts"
+  ],
+  "exclude": ["node_modules"]
+}