@santi020k/eslint-config-basic 0.1.0 → 0.3.0

package/.github/workflows/docs.yml

@@ -1,49 +0,0 @@
-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

@@ -1,18 +0,0 @@
-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

@@ -1,24 +0,0 @@
-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

@@ -1,35 +0,0 @@
-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

@@ -1,23 +0,0 @@
-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

@@ -1,31 +0,0 @@
-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

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

package/.vscode/extensions.json

@@ -1,10 +0,0 @@
-{
-  "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

@@ -1,55 +0,0 @@
-{
-  // 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

@@ -1,16 +0,0 @@
-# 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

@@ -1,194 +0,0 @@
-# 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

@@ -1,4 +0,0 @@
-# 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

@@ -1,21 +0,0 @@
-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.

package/config/.husky/commit-msg

@@ -1,9 +0,0 @@
-#!/bin/sh
-if ! head -1 "$1" | grep -qE "^(feat|fix|chore|docs|test|style|refactor|perf|build|ci|revert)(\(.+?\))?: .{1,}$"; then
-    echo "Aborting commit. Your commit message is invalid." >&2
-    exit 1
-fi
-if ! head -1 "$1" | grep -qE "^.{1,200}$"; then
-    echo "Aborting commit. Your commit message is too long." >&2
-    exit 1
-fi

package/config/.husky/pre-commit

@@ -1 +0,0 @@
-npm run pre-commit

package/config/.husky/pre-push

@@ -1 +0,0 @@
-npm run pre-push

package/config/.husky/prepare-commit-msg

@@ -1 +0,0 @@
-exec < /dev/tty && npx cz --hook || true

package/cspell.config.yaml

@@ -1,2 +0,0 @@
-words:
-  - santi

package/eslint.config.js

@@ -1,21 +0,0 @@
-// @ts-check
-import { ConfigOption, eslintConfig, OptionalOption } from '@santi020k/eslint-config-basic'
-
-export default [
-  ...eslintConfig({
-    config: [ConfigOption.Ts],
-    optionals: [OptionalOption.Mdx, OptionalOption.Markdown, OptionalOption.Vitest]
-  }),
-  {
-    name: 'local-config',
-    ignores: [
-      'dist/*',
-      'packages/*/dist/*',
-      '**/tsup.config.ts',
-      'docs/*',
-      'docs-md/*',
-      'typedoc.config.mjs',
-      'typedoc.markdown.mjs'
-    ]
-  }
-]

package/llms.txt

@@ -1,72 +0,0 @@
-# @santi020k/eslint-config-basic
-
-> A comprehensive ESLint configuration package for JavaScript, TypeScript, React, Next.js, Astro, and Expo projects.
-
-## AI Assistant Context
-**Role**: You are a senior software engineer maintaining this high-quality ESLint config package.
-**Goal**: Ensure code quality, type safety, and seamless developer experience (DX).
-**Style**: Strict but practical. Prefer correctness over brevity.
-
-## Quick Start
-
-```js
-import { ConfigOption, eslintConfig, OptionalOption } from '@santi020k/eslint-config-basic'
-
-export default [
-  ...eslintConfig({
-    config: [ConfigOption.React, ConfigOption.Ts],
-    optionals: [OptionalOption.Tailwind, OptionalOption.Vitest]
-  })
-]
-```
-
-## Architecture
-
-This is a monorepo-style ESLint config package using ESLint 9 Flat Config format.
-
-### Directory Structure
-
-packages/
-├── basic/            # Main entry point (@santi020k/eslint-config-basic)
-│   ├── src/index.ts  # Exports eslintConfig()
-│   └── dist/         # Build artifacts
-├── core/             # Core logic and shared types
-├── typescript/       # TypeScript config
-├── react/            # React config
-├── next/             # Next.js config
-├── astro/            # Astro config
-├── expo/             # Expo config
-├── optionals/        # Optional feature configs
-├── playground/       # Internal testing playground
-└── tests/            # Integration tests
-
-### Key Enums
-
-- **ConfigOption**: `Ts`, `React`, `Next`, `Expo`, `Astro`
-- **OptionalOption**: `Cspell`, `Tailwind`, `Vitest`, `I18next`, `Mdx`, `Markdown`, `Stencil`
-- **SettingOption**: `Gitignore`
-
-## Commands
-
-```bash
-npm run build       # Build with tsup
-npm run lint        # Run ESLint
-npm run lint:fix    # Fix linting issues
-npm run dev         # Watch mode development
-npm run inspector   # Open ESLint config inspector
-```
-
-## Adding New Configurations
-
-1. Create a new package under `packages/` (e.g. `packages/vue`).
-2. Implement the config in `src/index.ts` of that package.
-3. Export it from the package's entry point.
-4. Add to `ConfigOption` enum in `packages/core/src/types.ts`.
-5. Wire up in `packages/basic/src/index.ts`.
-
-## Tech Stack
-
-- **Build**: tsup, TypeScript
-- **ESLint**: v9+ Flat Config format
-- **Package Manager**: npm/pnpm
-- **Node**: ^18.18.0 || ^20.9.0 || >=21.1.0

package/packages/astro/README.md

@@ -1,13 +0,0 @@
-# @santi020k/eslint-config-astro
-
-Astro specific ESLint rules and configurations.
-
-## Description
-
-This package provides:
-- `eslint-plugin-astro` recommended rules.
-- Configuration for linting `.astro` files.
-
-## Usage
-
-This package is used automatically when `ConfigOption.Astro` is selected in the main configuration.

package/packages/astro/package.json

@@ -1,45 +0,0 @@
-{
-  "name": "@santi020k/eslint-config-astro",
-  "version": "0.0.0",
-  "description": "Astro ESLint configuration",
-  "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"
-  },
-  "peerDependencies": {
-    "eslint": "^9.0.0"
-  },
-  "dependencies": {
-    "@santi020k/eslint-config-core": "*",
-    "eslint-plugin-astro": "^1.3.1"
-  },
-  "devDependencies": {
-    "@typescript-eslint/utils": "^8.54.0",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "author": "santi020k",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/santi020k/eslint-config.git",
-    "directory": "packages/astro"
-  }
-}