@santi020k/eslint-config-basic 0.1.0

package/.github/workflows/build.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x]
+
+    steps:
+      - uses: actions/checkout@v6
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+      - run: npm ci
+      - run: npm run build
+      - run: npm run lint
+      - run: npm run test
+      - name: Dry-run publish check
+        run: npm publish --dry-run -w packages/basic

package/.github/workflows/codeql.yml

@@ -0,0 +1,40 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  schedule:
+    - cron: '21 7 * * 0'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'javascript', 'typescript' ]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"

package/.github/workflows/docs.yml

@@ -0,0 +1,49 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+          cache: 'npm'
+      - run: npm ci
+      - run: npm run build
+      - name: Generate docs
+        run: npm run docs
+      - name: Create .nojekyll
+        run: touch docs/.nojekyll
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: docs
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.github/workflows/labeler.yml

@@ -0,0 +1,18 @@
+name: PR Labeler
+
+on:
+  pull_request_target:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  label:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/labeler@v6
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to NPM
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+      - name: Install dependencies and build
+        run: npm ci && npm run build
+      - name: Publish package on NPM
+        run: npm publish -w packages/basic
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/release.yml

@@ -0,0 +1,35 @@
+name: Releases
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  changelog:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+
+      - name: Generate Conventional Changelog
+        id: changelog
+        uses: TriPSs/conventional-changelog-action@v6
+        with:
+          github-token: ${{ secrets.PA_TOKEN }}
+          version-file: './package.json,./package-lock.json'
+
+      - name: Create GitHub Release
+        if: ${{ steps.changelog.outputs.skipped == 'false' }}
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.changelog.outputs.tag }}
+          name: ${{ steps.changelog.outputs.tag }}
+          body: ${{ steps.changelog.outputs.clean_changelog }}
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.PA_TOKEN }}

package/.github/workflows/size-check.yml

@@ -0,0 +1,23 @@
+name: Package Size
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  size:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v6
+      - uses: pkg-size/action@v1
+        with:
+          build-command: npm run build
+          display-size: uncompressed,gzip
+          comment-report: true
+          unchanged-files: collapse
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/stale.yml

@@ -0,0 +1,31 @@
+name: Stale Issues & PRs
+
+on:
+  schedule:
+    - cron: '0 0 * * *' # Daily at midnight UTC
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/stale@v10
+        with:
+          stale-issue-message: >
+            This issue has been automatically marked as stale because it has not had
+            recent activity. It will be closed in 7 days if no further activity occurs.
+          stale-pr-message: >
+            This PR has been automatically marked as stale because it has not had
+            recent activity. It will be closed in 7 days if no further activity occurs.
+          days-before-issue-stale: 30
+          days-before-issue-close: 7
+          days-before-pr-stale: 14
+          days-before-pr-close: 7
+          stale-issue-label: stale
+          stale-pr-label: stale
+          exempt-issue-labels: pinned,security
+          exempt-pr-labels: pinned,security

package/.nvmrc

@@ -0,0 +1 @@
+v22.9.0

package/.vscode/extensions.json

@@ -0,0 +1,10 @@
+{
+  "recommendations": [
+      "davidanson.vscode-markdownlint",
+      "dbaeumer.vscode-eslint",
+      "editorconfig.editorconfig",
+      "streetsidesoftware.code-spell-checker",
+      "mrmlnc.vscode-json5"
+  ],
+  "unwantedRecommendations": ["hookyqr.beautify", "dbaeumer.jshint"]
+}

package/.vscode/settings.json

@@ -0,0 +1,55 @@
+{
+  // This matches the value configured on the autoformatter
+  "editor.rulers": [80],
+
+  // An array of language ids which should be validated by ESLint
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "markdown",
+    "md",
+    "mdx"
+  ],
+  // required to make the extension pickup the flat config
+  "eslint.useFlatConfig": true,
+
+  // When enabled, will trim trailing whitespace when saving a file.
+  "files.trimTrailingWhitespace": true,
+
+  // typescript auto-format settings
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "javascript.preferences.importModuleSpecifier": "project-relative",
+  "typescript.preferences.importModuleSpecifier": "project-relative",
+  "javascript.preferences.quoteStyle": "single",
+  "typescript.preferences.quoteStyle": "single",
+
+  // make the .shot files from jest-specific-snapshot act like normal snapshots
+  "files.associations": {
+    "*.shot": "jest-snapshot"
+  },
+
+  "editor.formatOnSave": true,
+  "editor.formatOnPaste": true,
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint"
+  },
+  "[scss]": {
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint"
+  },
+  "files.exclude": {
+    "**/.git": true,
+    "**/.svn": true,
+    "**/.hg": true,
+    "**/CVS": true,
+    "**/.DS_Store": true,
+    "**/Thumbs.db": true,
+    "**/node_modules": false
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint"
+  },
+  "eslint.runtime": "/Users/san/.nvm/versions/node/v22.9.0/bin/node",
+  "json.trace.server": "verbose",
+}

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# 0.1.0 (2026-02-10)
+
+
+### Features
+
+* Add  and  scripts to . ([9438293](https://github.com/santi020k/eslint-config-basic/commit/94382934292682ac82a24a4bf433b621687a23cb))
+* Add Vitest ESLint configuration and include test files in linting and TypeScript compilation. ([db249e0](https://github.com/santi020k/eslint-config-basic/commit/db249e06d0c3270a5b61d7a77706cdd5f1773e0f))
+* Add Vitest for comprehensive testing of ESLint configurations and rules. ([452d988](https://github.com/santi020k/eslint-config-basic/commit/452d988eb265fdd3abe0af0f690d86b77b4031d6))
+* Implement GitHub Actions for repository automation, including stale issue management, dependency updates, PR labeling, security audits, package size checks, and an updated build workflow ([d5e77b7](https://github.com/santi020k/eslint-config-basic/commit/d5e77b7f8b12c7854892606172495c03f1db6052))
+* Initial commit ([e527968](https://github.com/santi020k/eslint-config-basic/commit/e527968e975a9a0b5451eaee4462c315fe3c525b))
+* Introduce AI agent guidelines, instructions, and project context, alongside minor code formatting and updated ESLint ignore patterns. ([c2e0d74](https://github.com/santi020k/eslint-config-basic/commit/c2e0d749ae92666e529517c02356ab385755cb0d))
+* **nest:** Add NestJS ESLint Configuration Package ([#7](https://github.com/santi020k/eslint-config-basic/issues/7)) ([73d11df](https://github.com/santi020k/eslint-config-basic/commit/73d11df268e1f9fa524f66459274d3e4310c7db5))
+* restructure ESLint configuration into a monorepo with core, TypeScript, React, and Next.js packages, and implement a new build system using tsup and TurboRepo. ([f5516c6](https://github.com/santi020k/eslint-config-basic/commit/f5516c6ebb9a5a06bd86420b62c98bd125aff03c))
+
+
+

package/CONTRIBUTING.md

@@ -0,0 +1,194 @@
+# Contributing to @santi020k/eslint-config-basic
+
+Thank you for your interest in contributing! This guide will help you get started.
+
+## Prerequisites
+
+- Node.js (version specified in `.nvmrc`)
+- npm
+
+## Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/santi020k/eslint-config-basic.git
+cd eslint-config-basic
+
+# Install dependencies
+npm install
+
+# Build all packages
+npm run build
+```
+
+## Monorepo Structure
+
+This project uses **Turborepo** with **npm Workspaces**. Each ESLint config lives in its own package under `packages/`:
+
+| Package | Path | Description |
+|---------|------|-------------|
+| `@santi020k/eslint-config-basic` | `packages/basic` | Main entry point, composes all configs |
+| `@santi020k/eslint-config-core` | `packages/core` | Core JS rules, types, utilities |
+| `@santi020k/eslint-config-typescript` | `packages/typescript` | TypeScript rules |
+| `@santi020k/eslint-config-react` | `packages/react` | React + Hooks rules |
+| `@santi020k/eslint-config-next` | `packages/next` | Next.js rules |
+| `@santi020k/eslint-config-astro` | `packages/astro` | Astro rules |
+| `@santi020k/eslint-config-expo` | `packages/expo` | Expo/React Native rules |
+| `@santi020k/eslint-config-optionals` | `packages/optionals` | Optional configs (Tailwind, Vitest, etc.) |
+
+## Adding a New Framework Config
+
+1. **Create the package directory:**
+
+   ```bash
+   mkdir -p packages/myframework/src
+   ```
+
+2. **Create `packages/myframework/package.json`:**
+
+   ```json
+   {
+     "name": "@santi020k/eslint-config-myframework",
+     "version": "0.0.0",
+     "type": "module",
+     "main": "./dist/index.js",
+     "module": "./dist/index.js",
+     "types": "./dist/index.d.ts",
+     "exports": {
+       ".": {
+         "import": "./dist/index.js",
+         "types": "./dist/index.d.ts"
+       }
+     },
+     "files": ["dist"],
+     "scripts": {
+       "build": "tsup",
+       "dev": "tsup --watch",
+       "clean": "rm -rf dist"
+     },
+     "dependencies": {
+       "@santi020k/eslint-config-core": "*"
+     },
+     "devDependencies": {
+       "tsup": "^8.5.1",
+       "typescript": "^5.9.3",
+       "@typescript-eslint/utils": "^8.54.0"
+     }
+   }
+   ```
+
+3. **Create `packages/myframework/tsconfig.json`:**
+
+   ```json
+   {
+     "extends": "../../tsconfig.base.json",
+     "compilerOptions": {
+       "outDir": "./dist",
+       "rootDir": "./src"
+     },
+     "include": ["src/**/*.ts"],
+     "exclude": ["node_modules", "dist"]
+   }
+   ```
+
+4. **Create `packages/myframework/tsup.config.ts`** (copy from an existing package).
+
+5. **Create `packages/myframework/src/index.ts`:**
+
+```typescript
+import type { TSESLint } from '@typescript-eslint/utils'
+
+export const myframeworkConfig: TSESLint.FlatConfig.ConfigArray = [
+  {
+    name: 'eslint-config/myframework',
+    rules: {
+      // Add your rules here
+    }
+  }
+]
+```
+
+6. **Add to `ConfigOption` enum** in `packages/core/src/types.ts`.
+
+7. **Wire into `eslintConfig()`** in `packages/basic/src/index.ts`.
+
+8. **Add tests** in `packages/tests/src/`.
+9. **Update `ConfigOption` enum** in `packages/core/src/types.ts`.
+10. **Wire into `eslintConfig()`** in `packages/basic/src/index.ts`.
+
+### Specific Framework Guides
+
+#### React, Next.js, Astro, Expo, NestJS
+These are already implemented. See their respective `packages/` for reference.
+
+#### Vue (Future)
+1. Create `packages/vue`.
+2. Extend `eslint-plugin-vue` configs.
+3. Ensure TS compatibility.
+
+#### Angular (Future)
+1. Create `packages/angular`.
+2. Use `angular-eslint` capabilities.
+3. Note: Angular often requires a specific `builder` context.
+
+
+
+## Adding a New Optional
+
+1. Create `packages/optionals/src/configs/myoptional.ts` with your config.
+2. Export from `packages/optionals/src/index.ts`.
+3. Add to `OptionalOption` enum in `packages/core/src/types.ts`.
+4. Wire into `eslintConfig()` in `packages/basic/src/index.ts`.
+
+## Available Commands
+
+```bash
+npm run build      # Build all packages (Turborepo)
+npm run lint       # Lint entire monorepo
+npm run lint:fix   # Fix lint issues
+npm run test       # Run tests (Vitest)
+npm run dev        # Watch mode
+npm run dev        # Watch mode
+npm run inspector  # Visual ESLint config inspector
+```
+
+## Documentation
+
+Full API documentation is available at [santi020k.github.io/eslint-config-basic](https://santi020k.github.io/eslint-config-basic/).
+
+## Commit Conventions
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/). Use one of the following prefixes:
+
+- `feat:` — New feature
+- `fix:` — Bug fix
+- `docs:` — Documentation only
+- `style:` — Formatting, no code change
+- `refactor:` — Code restructuring
+- `perf:` — Performance improvement
+- `test:` — Adding or updating tests
+- `build:` — Build system changes
+- `ci:` — CI/CD changes
+- `chore:` — Maintenance tasks
+- `revert:` — Revert a previous commit
+
+You can use the interactive commit helper:
+
+```bash
+npx cz
+```
+
+## Pull Request Guidelines
+
+1. Fork the repository and create your branch from `main`.
+2. Make sure all checks pass:
+   ```bash
+   npm run build && npm run lint && npm run test
+   ```
+3. Write clear, descriptive commit messages following conventional commits.
+4. Update documentation if you're changing public APIs.
+5. Add tests for new functionality.
+
+## Questions?
+
+Open an [issue](https://github.com/santi020k/eslint-config/issues) or start a [discussion](https://github.com/santi020k/eslint-config/discussions).

package/DEVELOPMENT.md

@@ -0,0 +1,4 @@
+# Development
+
+See **[https://github.com/santi020k/eslint-config-santi020k/README.md](https://github.com/santi020k/eslint-config-santi020k/README.md)** for our development instructions.
+Thanks! 💖

package/LICENSE

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