@hyeon/linter 10.0.1-dev.1.29 → 11.0.1-dev.2.41

package/README.md

@@ -1,25 +1,80 @@
-## Installation
+# @hyeon/linter
 
 ```bash
-npm install --save-dev @hyeon/linter
+npm install --save-dev @hyeon/linter oxlint
 ```
 
-## Usage
+> AI 사용자용: 설치/셋업 가이드는 [`install.md`](./install.md), 사용 예시는 [`USAGE_EXAMPLES.md`](./USAGE_EXAMPLES.md)를 먼저 확인하세요.
 
-```js
-import hyeonLinter from '@hyeon/linter'
+## 지원 정책
 
-export default [
-  ...hyeonLinter.react,
-  ...hyeonLinter.prettier,
-  ...hyeonLinter.typescript,
-]
+- TypeScript 5.9+ 전용
+- OXC 기반 (oxlint + oxfmt)
+- ESLint/Prettier 레거시 경로는 v11에서 완전 제거됨
+
+## 사용 가이드
+
+### 린트 설정 (`oxlint.config.ts`)
+
+```ts
+import { defineConfig } from "oxlint";
+import { hansanghyeon, recommended, react, typescript } from "@hyeon/linter";
+
+export default defineConfig({
+  extends: [recommended, typescript, react, hansanghyeon],
+  options: {
+    typeAware: true,
+  },
+});
+```
+
+### 개별 모듈 조합
+
+```ts
+import { defineConfig } from "oxlint";
+import { recommended, typescript } from "@hyeon/linter";
+
+export default defineConfig({
+  extends: [recommended, typescript],
+});
 ```
 
-## vite
+## 포맷터 템플릿 가이드
 
-uninstall
+- `@hyeon/linter/oxfmt-template`는 코드로 import할 수 있는 모듈이 아니라
+  프로젝트로 복사해 두어야 하는 **정적 템플릿 파일**입니다.
 
 ```bash
-eslint-plugin-react-hooks eslint-plugin-react-refresh typescript-eslint globals @eslint/js
+# 최초 복사
+cp ./node_modules/@hyeon/linter/templates/oxfmt.base.jsonc ./.oxfmtrc.jsonc
+
+# 포맷 검사
+npx --no-install oxfmt --config ./.oxfmtrc.jsonc --check ./src
+
+# 포맷 적용
+npx --no-install oxfmt --config ./.oxfmtrc.jsonc --write ./src
 ```
+
+## v10 → v11 마이그레이션
+
+v11은 **Breaking Change**입니다. ESLint/Prettier 레거시 경로가 모두 제거되었습니다.
+
+### 제거된 항목
+
+- `@hyeon/linter` (기존 ESLint 설정 객체 export) → `@hyeon/linter` (oxlint 설정으로 대체)
+- `@hyeon/linter/legacy`
+- `@hyeon/linter/recommended` (ESLint base)
+- `@hyeon/linter/typescript` (typescript-eslint)
+- `@hyeon/linter/react` (eslint-plugin-react)
+- `@hyeon/linter/prettier` (eslint-plugin-prettier)
+- `@hyeon/linter/hansanghyeon` (ESLint custom)
+- `eslint`, `prettier` peerDependencies
+- `fallbackRules` export
+
+### 마이그레이션 방법
+
+1. `eslint.config.mjs` 삭제
+2. `oxlint.config.ts` 생성 (위 예시 참고)
+3. `.oxfmtrc.jsonc` 복사 (위 포맷터 가이드 참고)
+4. `eslint`, `prettier` 및 관련 플러그인 devDependencies 제거
+5. lint 스크립트를 `oxlint --config oxlint.config.ts` 으로 변경

package/package.json

@@ -1,26 +1,32 @@
 {
   "name": "@hyeon/linter",
-  "version": "10.0.1-dev.1.29",
-  "description": "Hansanghyun custom eslint settings",
-  "main": "./src/index.mjs",
+  "version": "11.0.1-dev.2.41",
+  "description": "OXC-based lint and format configuration (oxlint + oxfmt)",
+  "main": "./src/oxlint.mjs",
   "scripts": {
-    "lint": "eslint src/",
-    "test": "npm run lint"
+    "lint": "npm run lint:oxlint && npm run format:check",
+    "lint:oxlint": "oxlint --type-aware --config oxlint.config.ts src test/src",
+    "lint:oxlint:syntax": "oxlint --config oxlint.config.ts src test/src",
+    "format:write": "npx --no-install oxfmt --config ./.oxfmtrc.jsonc ./templates/oxfmt.base.jsonc",
+    "format:check": "npx --no-install oxfmt --config ./.oxfmtrc.jsonc --check ./templates/oxfmt.base.jsonc",
+    "test": "npm run lint && npm --prefix test run test:all"
   },
   "repository": {
     "type": "git",
     "url": "git+https://git.hyeon.pro/hansanghyeon/linter.git"
   },
   "keywords": [
-    "eslint",
-    "eslintconfig",
+    "oxlint",
+    "oxfmt",
+    "oxc",
+    "linter",
+    "formatter",
     "hyeon",
     "javascript",
     "react",
     "nextjs",
     "nestjs",
-    "typescript",
-    "prettier"
+    "typescript"
   ],
   "author": "hyeon",
   "license": "MIT",
@@ -29,42 +35,32 @@
   },
   "homepage": "https://git.hyeon.pro/hansanghyeon/linter#readme",
   "dependencies": {
-    "@eslint/js": "^10.0.1",
-    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import-x": "^4.16.1",
-    "eslint-plugin-prettier": "^5.5.5",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-refresh": "^0.5.0",
-    "prettier": "^3.5.3",
-    "prettier-plugin-tailwindcss": "^0.7.2",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.55.0"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "eslint": "^10.0.0",
-    "prettier": "^3.5.3"
+    "oxlint": ">=1.0.0"
   },
   "devDependencies": {
-    "eslint": "^10.0.0"
+    "oxfmt": "^0.37.0",
+    "oxlint": "^1.52.0",
+    "oxlint-tsgolint": "^0.16.0"
   },
   "exports": {
     ".": {
-      "import": "./src/index.mjs",
-      "require": "./src/index.mjs",
-      "default": "./src/index.mjs"
+      "types": "./src/oxlint.d.ts",
+      "import": "./src/oxlint.mjs",
+      "default": "./src/oxlint.mjs"
     },
-    "./recommended": "./src/base.mjs",
-    "./typescript": "./src/typescript.mjs",
-    "./react": "./src/react.mjs",
-    "./prettier": "./src/prettier.mjs",
-    "./hansanghyeon": "./src/hansanghyeon.mjs",
+    "./oxlint": {
+      "types": "./src/oxlint.d.ts",
+      "import": "./src/oxlint.mjs",
+      "default": "./src/oxlint.mjs"
+    },
+    "./oxfmt-template": "./templates/oxfmt.base.jsonc",
     "./package.json": "./package.json"
   },
   "files": [
-    "typescript",
-    "react",
-    "prettier",
-    "src"
+    "src",
+    "templates"
   ]
 }

package/src/oxlint.d.ts

@@ -0,0 +1,8 @@
+import type { OxlintConfig } from "oxlint";
+
+type OxlintConfigSnippet = Omit<OxlintConfig, "extends" | "$schema">;
+
+export declare const recommended: OxlintConfigSnippet;
+export declare const typescript: OxlintConfigSnippet;
+export declare const react: OxlintConfigSnippet;
+export declare const hansanghyeon: OxlintConfigSnippet;

package/src/oxlint.mjs

@@ -0,0 +1,38 @@
+const fullRepoIgnorePatterns = [
+  "**/node_modules/**",
+  "**/dist/**",
+  "**/.turbo/**",
+  "**/coverage/**",
+];
+
+export const recommended = {
+  ignorePatterns: fullRepoIgnorePatterns,
+  categories: {
+    correctness: "warn",
+    suspicious: "warn",
+    pedantic: "off",
+    perf: "off",
+    style: "off",
+    restriction: "off",
+    nursery: "off",
+  },
+};
+
+export const typescript = {
+  plugins: ["typescript"],
+  rules: {
+    "typescript/no-explicit-any": "off",
+  },
+};
+
+export const react = {
+  plugins: ["react"],
+};
+
+export const hansanghyeon = {
+  rules: {
+    "no-empty-pattern": "off",
+    camelcase: "off",
+    "no-multi-spaces": "off",
+  },
+};

package/templates/oxfmt.base.jsonc

@@ -0,0 +1,23 @@
+{
+  "printWidth": 120,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": false,
+  "singleQuote": true,
+  "jsxSingleQuote": false,
+  "trailingComma": "all",
+  "sortImports": {
+    "newlinesBetween": false,
+    "internalPattern": ["~/", "@/"],
+    "groups": [
+      ["value-builtin", "value-external", "value-internal", "value-subpath"],
+      ["type-builtin", "type-external", "type-internal", "type-subpath"],
+      ["value-parent", "value-sibling", "value-index"],
+      ["type-parent", "type-sibling", "type-index"],
+      "unknown",
+    ],
+  },
+  "sortTailwindcss": {
+    "functions": ["clsx", "cn"],
+  },
+}

package/src/base.mjs

@@ -1,3 +0,0 @@
-import js from '@eslint/js'
-
-export default [js.configs.recommended]

package/src/hansanghyeon.mjs

@@ -1,50 +0,0 @@
-import importX from 'eslint-plugin-import-x'
-
-const _import = [
-  importX.flatConfigs.recommended,
-  {
-    rules: {
-      'import-x/first': 'error',
-      'import-x/newline-after-import': 'error',
-      'import-x/no-duplicates': 'error',
-      'import-x/no-unresolved': 'off',
-    },
-  },
-]
-
-const custom = {
-  rules: {
-    'no-empty-pattern': 'off',
-    'lines-around-comment': 'off',
-    camelcase: 'off',
-    'class-methods-use-this': 'off',
-    'no-multi-spaces': [
-      'error',
-      {
-        ignoreEOLComments: true,
-      },
-    ],
-
-    // 보일러플레이트 코드를 생성할때 {} 를 사용하는 경우가 많아서 off
-
-    '@typescript-eslint/no-empty-object-type': 'off',
-    '@typescript-eslint/no-explicit-any': 'off',
-    '@typescript-eslint/no-unused-vars': [
-      'error',
-      {
-        vars: 'all',
-        varsIgnorePattern: '^_.*$|^_$|^P$|^flow$|^pipe$',
-        args: 'all',
-        argsIgnorePattern: '^_.*$|^_$|^P$|^flow$|^pipe$',
-        caughtErrors: 'all',
-        caughtErrorsIgnorePattern: '^_.*$|^_$|^P$|^flow$|^pipe$',
-        destructuredArrayIgnorePattern: '^_.*$|^_$|^P$|^flow$|^pipe$',
-        ignoreRestSiblings: true,
-      },
-    ],
-    'no-confusing-arrow': 'off',
-  },
-  ignores: ['.config/*', 'eslint.config.mjs', 'eslint.config.js'],
-}
-
-export default [custom, ..._import]

package/src/index.mjs

@@ -1,29 +0,0 @@
-import hyeonEslintConfigBase from './base.mjs'
-import hyeonEslintConfigHansanghyeon from './hansanghyeon.mjs'
-import hyeonEslintConfigPrettier from './prettier.mjs'
-import hyeonEslintConfigReact from './react.mjs'
-import hyeonEslintConfigTypescript from './typescript.mjs'
-
-// 기존 사용자를 위한 객체 형태 유지 (각 속성이 flat config 배열)
-
-const configs = {
-  recommended: hyeonEslintConfigBase,
-  prettier: hyeonEslintConfigPrettier,
-  react: hyeonEslintConfigReact,
-  typescript: hyeonEslintConfigTypescript,
-  hansanghyeon: hyeonEslintConfigHansanghyeon,
-}
-
-// Default export는 설정 객체
-
-export default configs
-
-// Named exports로도 개별 설정 제공
-
-export {
-  hyeonEslintConfigBase as recommended,
-  hyeonEslintConfigPrettier as prettier,
-  hyeonEslintConfigReact as react,
-  hyeonEslintConfigTypescript as typescript,
-  hyeonEslintConfigHansanghyeon as hansanghyeon,
-}

package/src/prettier.mjs

@@ -1,68 +0,0 @@
-import eslintConfigPrettier from 'eslint-config-prettier'
-import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended'
-
-export default [
-  eslintConfigPrettier,
-  {
-    ...eslintPluginPrettierRecommended,
-    rules: {
-      'prettier/prettier': [
-        'error',
-        {
-          trailingComma: 'all',
-          singleQuote: true,
-          semi: false,
-          tabWidth: 2,
-          printWidth: 120,
-          arrowParens: 'always',
-          jsxSingleQuote: false,
-          plugins: ['@trivago/prettier-plugin-sort-imports', 'prettier-plugin-tailwindcss'],
-          importOrder: ['^[^.](.*)$', '^[.]{1,2}/.*$'],
-          importOrderSeparation: false,
-          importOrderSortSpecifiers: true,
-
-          /**
-           * @see https://github.com/trivago/prettier-plugin-sort-imports/issues/120
-           */
-
-          importOrderParserPlugins: ['typescript', 'decorators-legacy', 'jsx', 'classProperties'],
-        },
-      ],
-      'arrow-body-style': ['error', 'as-needed'],
-      'prefer-arrow-callback': 'error',
-      curly: ['error', 'all'],
-      'lines-around-comment': [
-        'error',
-        {
-          beforeBlockComment: true,
-          afterBlockComment: true,
-          beforeLineComment: true,
-          afterLineComment: true,
-          allowBlockStart: true,
-          allowBlockEnd: true,
-          allowObjectStart: true,
-          allowObjectEnd: true,
-          allowArrayStart: true,
-          allowArrayEnd: true,
-        },
-      ],
-      'max-len': 'off',
-      'no-confusing-arrow': [
-        'error',
-        {
-          allowParens: false,
-        },
-      ],
-      'no-mixed-operators': 'error',
-      'no-tabs': 'error',
-      quotes: [
-        'error',
-        'single',
-        {
-          avoidEscape: true,
-          allowTemplateLiterals: false,
-        },
-      ],
-    },
-  },
-]

package/src/react.mjs

@@ -1,17 +0,0 @@
-import react from 'eslint-plugin-react'
-import { reactRefresh } from 'eslint-plugin-react-refresh'
-
-export default [
-  {
-    settings: { react: { version: '19.0' } },
-    plugins: {
-      react,
-      'react-refresh': reactRefresh.plugin,
-    },
-    rules: {
-      ...react.configs.recommended.rules,
-      ...react.configs['jsx-runtime'].rules,
-      ...reactRefresh.configs.recommended().rules,
-    },
-  },
-]

package/src/typescript.mjs

@@ -1,50 +0,0 @@
-import js from '@eslint/js'
-import eslintConfigPrettier from 'eslint-config-prettier'
-import tseslint from 'typescript-eslint'
-
-// tseslint.config()는 이미 flat config 배열을 반환
-
-const config = [
-  {
-    ignores: ['**/node_modules/**', '**/dist/**', '**/.turbo/**', '**/coverage/**'],
-  },
-  js.configs.recommended,
-  ...tseslint.configs.recommended,
-  eslintConfigPrettier,
-  {
-    files: ['**/*.ts', '**/*.tsx', '**/*.mts', '**/*.cts'],
-    languageOptions: {
-      parser: tseslint.parser,
-      parserOptions: {
-        ecmaVersion: 'latest',
-        sourceType: 'module',
-        ecmaFeatures: {
-          decorators: true,
-        },
-      },
-    },
-    rules: {
-      '@typescript-eslint/no-explicit-any': 'off',
-      '@typescript-eslint/no-unused-vars': [
-        'error',
-        {
-          argsIgnorePattern: '^_',
-          varsIgnorePattern: '^_',
-        },
-      ],
-      '@typescript-eslint/consistent-type-imports': [
-        'error',
-        {
-          prefer: 'type-imports',
-          fixStyle: 'inline-type-imports',
-          disallowTypeAnnotations: false,
-        },
-      ],
-      '@typescript-eslint/explicit-function-return-type': 'off',
-      '@typescript-eslint/explicit-module-boundary-types': 'off',
-      '@typescript-eslint/no-non-null-assertion': 'off',
-    },
-  },
-]
-
-export default config