@heyq02/rslint-config 0.0.0-stage → 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ari <mail@heyq02.cn>
+
+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

@@ -1,3 +1,94 @@
-# Temporary Holding Version
+# @heyq02/rslint-config
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm version][npm-version-src]][npm-version-href]
+[![Unit Test][unit-test-src]][unit-test-href]
+
+Opinionated [Rslint](https://rslint.rs/) flat-config preset, structured like [`@sxzz/eslint-config`](https://github.com/sxzz/eslint-config) and built on `@rslint/core` native presets.
+
+## Features
+
+- One-line config via `heyq02()`
+- JavaScript + TypeScript presets (`recommended` / `strict` / type-checked / stylistic)
+- Built-in Unicorn, import, Node, and Promise rules
+- Optional React, React Hooks, JSX a11y, Jest, and Rstest (auto-detected)
+- Ignores common build artifacts (`dist`, `coverage`, lockfiles, …)
+- Special-case overrides for CLIs, tests, config files, and components
+
+> Rslint only lints JS/TS script extensions (`.js` / `.ts` / `.jsx` / `.tsx` / …). Vue, JSON, YAML, and Markdown are out of scope.
+
+## Install
+
+```bash
+pnpm add -D @heyq02/rslint-config @rslint/core
+```
+
+## Usage
+
+```ts
+// rslint.config.ts
+import { heyq02 } from "@heyq02/rslint-config";
+
+export default heyq02({
+  // Features auto-detect installed packages when omitted
+  typescript: { typeChecked: true, strict: true },
+  react: true,
+  jest: false,
+});
+```
+
+Append project overrides as extra arguments:
+
+```ts
+export default heyq02(
+  { typescript: true },
+  {
+    rules: {
+      "no-console": "off",
+    },
+  },
+);
+```
+
+### Options
+
+| Option       | Default             | Description                                                             |
+| ------------ | ------------------- | ----------------------------------------------------------------------- |
+| `typescript` | auto (`typescript`) | `true` / `false` / `{ typeChecked, strict, stylistic, projectService }` |
+| `javascript` | `true`              | JavaScript recommended + opinionated rules                              |
+| `unicorn`    | `true`              | Unicorn recommended + overrides                                         |
+| `imports`    | `true`              | Import recommended + no-default-export, etc.                            |
+| `node`       | `true` (`module`)   | `true` / `'module'` / `'script'` / `'mixed'`                            |
+| `promise`    | `true`              | Promise recommended (relaxed for async/await)                           |
+| `react`      | auto (`react`)      | React + React Hooks (+ jsx-a11y)                                        |
+| `jsxA11y`    | with react          | JSX accessibility rules                                                 |
+| `jest`       | auto (`jest`)       | Jest recommended + style                                                |
+| `rstest`     | auto (`rstest`)     | Rstest recommended                                                      |
+| `ignores`    | `[]`                | Extra global ignore patterns                                            |
+
+### Presets
+
+```ts
+import { presetJavaScript, presetBasic, presetAll } from "@heyq02/rslint-config";
+
+export default presetBasic();
+```
+
+## Development
+
+```bash
+vp install
+vp pack
+vp check
+pnpm release   # bumpp → tag v* → GitHub Release + npm publish
+```
+
+## License
+
+[MIT](./LICENSE) © Ari
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/@heyq02/rslint-config.svg
+[npm-version-href]: https://npmjs.com/package/@heyq02/rslint-config
+[unit-test-src]: https://github.com/heyq02/rslint-config/actions/workflows/unit-test.yml/badge.svg
+[unit-test-href]: https://github.com/heyq02/rslint-config/actions/workflows/unit-test.yml

package/dist/index.d.mts

@@ -0,0 +1,183 @@
+import { RslintConfig, RslintConfigEntry } from "@rslint/core";
+//#region src/types.d.ts
+export type TypedFlatConfig = RslintConfigEntry;
+export type ResolvableConfig = TypedFlatConfig | TypedFlatConfig[] | RslintConfig | false | null | undefined;
+export type TypeScriptPreset = "recommended" | "recommendedTypeChecked" | "strict" | "strictTypeChecked";
+export interface TypeScriptOptions {
+  /**
+   * Enable type-aware TypeScript rules.
+   * When true, uses `*TypeChecked` presets and enables `projectService` by default.
+   * @default false
+   */
+  typeChecked?: boolean;
+  /**
+   * Use TypeScript strict presets instead of recommended.
+   * @default false
+   */
+  strict?: boolean;
+  /**
+   * Layer TypeScript stylistic rules after the baseline.
+   * @default true
+   */
+  stylistic?: boolean;
+  /**
+   * Enable automatic TypeScript project discovery for type-aware rules.
+   * Defaults to `true` when `typeChecked` is enabled.
+   */
+  projectService?: boolean;
+}
+export type NodePreset = boolean | "module" | "script" | "mixed";
+export interface Options {
+  /**
+   * Global ignore patterns. Merged with the built-in excludes.
+   */
+  ignores?: string[];
+  /**
+   * JavaScript support. @default true
+   */
+  javascript?: boolean;
+  /**
+   * TypeScript support. Auto-enabled when `typescript` is installed.
+   * Pass an object for type-checked / strict / stylistic controls.
+   * @default auto
+   */
+  typescript?: boolean | TypeScriptOptions;
+  /**
+   * Unicorn rules. @default true
+   */
+  unicorn?: boolean;
+  /**
+   * Import rules. @default true
+   */
+  imports?: boolean;
+  /**
+   * Node.js rules.
+   * - `true` / `'module'` — ESM-oriented Node rules (default)
+   * - `'script'` — CommonJS-oriented
+   * - `'mixed'` — upstream mixed recommended preset
+   * @default true
+   */
+  node?: NodePreset;
+  /**
+   * Promise rules. @default true
+   */
+  promise?: boolean;
+  /**
+   * React + React Hooks. Auto-enabled when React is detected.
+   * @default auto
+   */
+  react?: boolean;
+  /**
+   * JSX accessibility rules. Auto-enabled with React when unset.
+   * @default auto with react
+   */
+  jsxA11y?: boolean;
+  /**
+   * Jest rules. Auto-enabled when `jest` is detected.
+   * @default auto
+   */
+  jest?: boolean;
+  /**
+   * Rstest rules. Auto-enabled when `rstest` / `@rstest/core` is detected.
+   * @default auto
+   */
+  rstest?: boolean;
+}
+//#endregion
+//#region src/configs/ignores.d.ts
+export declare const ignores: (extra?: string[]) => TypedFlatConfig[];
+//#endregion
+//#region src/configs/imports.d.ts
+export declare const imports: (options?: {
+  typescript?: boolean;
+}) => TypedFlatConfig[];
+//#endregion
+//#region src/configs/javascript.d.ts
+export declare const restrictedSyntaxJs: string[];
+export declare const javascript: () => TypedFlatConfig[];
+//#endregion
+//#region src/configs/jest.d.ts
+export declare const jest: () => TypedFlatConfig[];
+//#endregion
+//#region src/configs/node.d.ts
+export declare const node: (preset?: Exclude<NodePreset, false>) => TypedFlatConfig[];
+//#endregion
+//#region src/configs/promise.d.ts
+export declare const promise: () => TypedFlatConfig[];
+//#endregion
+//#region src/configs/react.d.ts
+export declare const jsxA11y: () => TypedFlatConfig[];
+export declare const react: (options?: {
+  jsxA11y?: boolean;
+}) => TypedFlatConfig[];
+//#endregion
+//#region src/configs/rstest.d.ts
+export declare const rstest: () => TypedFlatConfig[];
+//#endregion
+//#region src/configs/special-cases.d.ts
+export declare const specialCases: () => TypedFlatConfig[];
+//#endregion
+//#region src/configs/typescript.d.ts
+export declare const typescript: (options?: true | TypeScriptOptions) => TypedFlatConfig[];
+//#endregion
+//#region src/configs/unicorn.d.ts
+export declare const unicorn: () => TypedFlatConfig[];
+//#endregion
+//#region src/env.d.ts
+export declare const hasTypeScript: () => boolean;
+export declare const hasReact: () => boolean;
+export declare const hasJest: () => boolean;
+export declare const hasRstest: () => boolean;
+export declare function isInEditorEnv(): boolean;
+export declare function isInGitHooksOrLintStaged(): boolean;
+//#endregion
+//#region src/globs.d.ts
+export declare const GLOB_SRC_EXT = "?([cm])[jt]s?(x)";
+export declare const GLOB_SRC = "**/*.?([cm])[jt]s?(x)";
+export declare const GLOB_JS = "**/*.?([cm])js";
+export declare const GLOB_JSX = "**/*.jsx";
+export declare const GLOB_TS = "**/*.?([cm])ts";
+export declare const GLOB_TSX = "**/*.tsx";
+export declare const GLOB_TESTS: readonly ["**/__tests__/**/*.?([cm])[jt]s?(x)", "**/*.spec.?([cm])[jt]s?(x)", "**/*.test.?([cm])[jt]s?(x)", "**/*.bench.?([cm])[jt]s?(x)", "**/*.benchmark.?([cm])[jt]s?(x)"];
+export declare const GLOB_NODE_MODULES: "**/node_modules";
+export declare const GLOB_DIST: "**/dist";
+export declare const GLOB_LOCKFILE: string[];
+export declare const GLOB_EXCLUDE: string[];
+//#endregion
+//#region src/presets.d.ts
+/** Ignore common files and include JavaScript support. */
+export declare const presetJavaScript: () => TypedFlatConfig[];
+/** Includes `presetJavaScript` and TypeScript support. */
+export declare const presetBasic: (typescriptOptions?: true | TypeScriptOptions) => TypedFlatConfig[];
+/**
+ * Full opinionated preset:
+ * - JS + TS
+ * - Unicorn / import / node / promise
+ * - React / Jest / Rstest when detected
+ * - Special-case overrides
+ */
+export declare const presetAll: () => TypedFlatConfig[];
+/**
+ * `@heyq02`'s opinionated Rslint config preset.
+ *
+ * @example
+ * ```ts
+ * // rslint.config.ts
+ * import { heyq02 } from '@heyq02/rslint-config'
+ *
+ * export default heyq02({
+ *   typescript: { typeChecked: true, strict: true },
+ *   react: true,
+ * })
+ * ```
+ */
+export declare function heyq02(options?: Options, ...userConfigs: ResolvableConfig[]): TypedFlatConfig[];
+/** Alias of {@link heyq02}. */
+export declare const rslintConfig: typeof heyq02;
+//#endregion
+//#region src/utils.d.ts
+/** Flatten nested config values into a single entry list. */
+export declare function flattenConfigs(...configs: ResolvableConfig[]): TypedFlatConfig[];
+export declare function toArray<T>(value: T | T[]): T[];
+//#endregion
+export type { RslintConfig, RslintConfigEntry };

package/dist/index.mjs

@@ -0,0 +1,522 @@
+import { createRequire } from "node:module";
+import { globalIgnores, globals, importPlugin, jestPlugin, js, jsxA11yPlugin, nodePlugin, promisePlugin, reactHooksPlugin, reactPlugin, rstestPlugin, ts, unicornPlugin } from "@rslint/core";
+import process from "node:process";
+//#region src/globs.ts
+const GLOB_SRC_EXT = "?([cm])[jt]s?(x)";
+const GLOB_SRC = `**/*.${GLOB_SRC_EXT}`;
+const GLOB_JS = "**/*.?([cm])js";
+const GLOB_JSX = "**/*.jsx";
+const GLOB_TS = "**/*.?([cm])ts";
+const GLOB_TSX = "**/*.tsx";
+const GLOB_TESTS = [
+	`**/__tests__/**/*.${GLOB_SRC_EXT}`,
+	`**/*.spec.${GLOB_SRC_EXT}`,
+	`**/*.test.${GLOB_SRC_EXT}`,
+	`**/*.bench.${GLOB_SRC_EXT}`,
+	`**/*.benchmark.${GLOB_SRC_EXT}`
+];
+const GLOB_NODE_MODULES = "**/node_modules";
+const GLOB_DIST = "**/dist";
+const GLOB_LOCKFILE = [
+	"**/package-lock.json",
+	"**/yarn.lock",
+	"**/pnpm-lock.yaml",
+	"**/bun.lock",
+	"**/bun.lockb"
+];
+const GLOB_EXCLUDE = [
+	GLOB_NODE_MODULES,
+	GLOB_DIST,
+	...GLOB_LOCKFILE,
+	"**/coverage",
+	"**/temp",
+	"**/tmp",
+	"**/fixtures",
+	"**/output",
+	"**/.vitepress/cache",
+	"**/.nuxt",
+	"**/.next",
+	"**/.vercel",
+	"**/.changeset",
+	"**/.idea",
+	"**/.output",
+	"**/.vite-inspect",
+	"**/.nitro",
+	"**/.turbo",
+	"**/CHANGELOG*.md",
+	"**/*.min.*",
+	"**/LICENSE*",
+	"**/__snapshots__",
+	"**/auto-import?(s).d.ts",
+	"**/components.d.ts"
+];
+//#endregion
+//#region src/configs/ignores.ts
+const ignores = (extra = []) => [{
+	...globalIgnores([...GLOB_EXCLUDE, ...extra]),
+	name: "heyq02/global-ignores"
+}];
+//#endregion
+//#region src/configs/imports.ts
+const imports = (options = {}) => [{
+	...importPlugin.configs.recommended,
+	files: [GLOB_SRC],
+	name: "heyq02/imports/recommended"
+}, {
+	files: [GLOB_SRC],
+	name: "heyq02/imports",
+	rules: {
+		"import/first": "error",
+		"import/no-default-export": "error",
+		"import/no-duplicates": ["error", { "prefer-inline": true }],
+		"import/no-mutable-exports": "error",
+		"import/no-named-default": "error",
+		...options.typescript ? {
+			"import/default": "off",
+			"import/named": "off",
+			"import/namespace": "off",
+			"import/no-unresolved": "off"
+		} : {}
+	}
+}];
+//#endregion
+//#region src/configs/javascript.ts
+const restrictedSyntaxJs = ["ForInStatement", "LabeledStatement"];
+const javascript = () => [{
+	...js.configs.recommended,
+	name: "heyq02/js/recommended"
+}, {
+	files: [GLOB_SRC],
+	languageOptions: {
+		ecmaVersion: "latest",
+		globals: {
+			...globals.browser,
+			...globals.es2026,
+			...globals.nodeBuiltin
+		},
+		sourceType: "module"
+	},
+	name: "heyq02/js",
+	rules: {
+		"array-callback-return": "error",
+		"block-scoped-var": "error",
+		"dot-notation": "warn",
+		eqeqeq: ["error", "smart"],
+		"no-alert": "warn",
+		"no-console": ["warn", { allow: [
+			"warn",
+			"error",
+			"info",
+			"clear"
+		] }],
+		"no-debugger": "warn",
+		"no-duplicate-imports": "error",
+		"no-empty": ["error", { allowEmptyCatch: true }],
+		"no-fallthrough": ["warn", { commentPattern: String.raw`break[\s\w]*omitted` }],
+		"no-inner-declarations": "error",
+		"no-lonely-if": "error",
+		"no-multi-str": "error",
+		"no-restricted-syntax": ["error", ...restrictedSyntaxJs],
+		"no-unused-expressions": ["error", {
+			allowShortCircuit: true,
+			allowTaggedTemplates: true,
+			allowTernary: true
+		}],
+		"no-unused-vars": ["error", {
+			args: "after-used",
+			argsIgnorePattern: "^_",
+			ignoreRestSiblings: true,
+			varsIgnorePattern: "^_"
+		}],
+		"no-useless-call": "error",
+		"no-useless-computed-key": "error",
+		"no-useless-constructor": "error",
+		"no-useless-rename": "error",
+		"no-var": "error",
+		"no-void": "error",
+		"object-shorthand": [
+			"error",
+			"always",
+			{
+				avoidQuotes: true,
+				ignoreConstructors: false
+			}
+		],
+		"one-var": ["error", { initialized: "never" }],
+		"prefer-arrow-callback": ["error", {
+			allowNamedFunctions: false,
+			allowUnboundThis: true
+		}],
+		"prefer-const": ["warn", {
+			destructuring: "all",
+			ignoreReadBeforeAssign: true
+		}],
+		"prefer-exponentiation-operator": "error",
+		"prefer-regex-literals": ["error", { disallowRedundantWrapping: true }],
+		"prefer-rest-params": "error",
+		"prefer-spread": "error",
+		"prefer-template": "error",
+		"require-await": "error",
+		"unicode-bom": ["error", "never"],
+		"use-isnan": ["error", {
+			enforceForIndexOf: true,
+			enforceForSwitchCase: true
+		}],
+		"valid-typeof": ["error", { requireStringLiterals: true }],
+		"vars-on-top": "error"
+	}
+}];
+//#endregion
+//#region src/configs/jest.ts
+const jest = () => [{
+	...jestPlugin.configs.recommended,
+	files: [...GLOB_TESTS],
+	name: "heyq02/jest/recommended"
+}, {
+	...jestPlugin.configs.style,
+	files: [...GLOB_TESTS],
+	name: "heyq02/jest/style"
+}];
+//#endregion
+//#region src/configs/node.ts
+const node = (preset = "module") => {
+	if (preset === "mixed") return nodePlugin.configs.recommended.map((entry, index) => ({
+		...entry,
+		name: entry.name ?? `heyq02/node/recommended-${index}`
+	}));
+	if (preset === "script") return [{
+		...nodePlugin.configs.recommendedScript,
+		files: [GLOB_SRC],
+		name: "heyq02/node/recommended-script"
+	}];
+	return [{
+		...nodePlugin.configs.recommendedModule,
+		files: [GLOB_SRC],
+		name: "heyq02/node/recommended-module"
+	}, {
+		files: [GLOB_SRC],
+		name: "heyq02/node",
+		plugins: ["node"],
+		rules: {
+			"node/handle-callback-err": ["error", "^(err|error)$"],
+			"node/no-deprecated-api": "error",
+			"node/no-exports-assign": "error",
+			"node/no-new-require": "error",
+			"node/no-path-concat": "error",
+			"node/prefer-global/buffer": ["error", "never"],
+			"node/prefer-global/process": ["error", "never"],
+			"node/process-exit-as-throw": "error"
+		}
+	}];
+};
+//#endregion
+//#region src/configs/promise.ts
+const promise = () => [{
+	...promisePlugin.configs.recommended,
+	files: [GLOB_SRC],
+	name: "heyq02/promise/recommended"
+}, {
+	files: [GLOB_SRC],
+	name: "heyq02/promise",
+	rules: {
+		"promise/always-return": "off",
+		"promise/catch-or-return": "off",
+		"promise/no-nesting": "off"
+	}
+}];
+//#endregion
+//#region src/configs/react.ts
+const reactFiles = [
+	GLOB_JSX,
+	GLOB_TSX,
+	"**/*.{jsx,tsx}"
+];
+const jsxA11y = () => [{
+	...jsxA11yPlugin.configs.recommended,
+	files: reactFiles,
+	name: "heyq02/jsx-a11y/recommended"
+}];
+const react = (options = {}) => {
+	const configs = [{
+		...reactPlugin.configs.recommended,
+		files: reactFiles,
+		name: "heyq02/react/recommended"
+	}, {
+		...reactHooksPlugin.configs.recommended,
+		files: reactFiles,
+		name: "heyq02/react-hooks/recommended"
+	}];
+	if (options.jsxA11y !== false) configs.push(...jsxA11y());
+	return configs;
+};
+//#endregion
+//#region src/configs/rstest.ts
+const rstest = () => [{
+	...rstestPlugin.configs.recommended,
+	files: [...GLOB_TESTS],
+	name: "heyq02/rstest/recommended"
+}];
+//#endregion
+//#region src/configs/special-cases.ts
+const specialCases = () => [
+	{
+		files: [
+			"**/scripts/*",
+			"**/cli.*",
+			"**/bin/**"
+		],
+		name: "heyq02/special/cli",
+		rules: { "no-console": "off" }
+	},
+	{
+		files: [`**/*.{test,spec}.${GLOB_SRC_EXT}`],
+		name: "heyq02/special/tests",
+		rules: {
+			"no-unused-expressions": "off",
+			"@typescript-eslint/no-unused-expressions": "off"
+		}
+	},
+	{
+		files: [
+			`**/*config*.${GLOB_SRC_EXT}`,
+			`**/{views,pages,routes,middleware,plugins,api,modules}/${GLOB_SRC}`,
+			`**/{index,vite,esbuild,rollup,rolldown,webpack,rspack,farm,unloader,nuxt,rslint}.${GLOB_SRC_EXT}`,
+			"**/*.d.ts",
+			"**/.prettierrc*"
+		],
+		name: "heyq02/special/allow-default-export",
+		rules: { "import/no-default-export": "off" }
+	},
+	{
+		files: ["**/ISSUE_TEMPLATE/**"],
+		name: "heyq02/special/github",
+		rules: { "unicorn/filename-case": "off" }
+	},
+	{
+		files: [GLOB_JSX, GLOB_TSX],
+		name: "heyq02/special/components",
+		rules: {
+			"unicorn/no-anonymous-default-export": "off",
+			"import/no-default-export": "off"
+		}
+	}
+];
+//#endregion
+//#region src/configs/typescript.ts
+function resolveTypeScriptOptions(options) {
+	if (options === true) return {
+		typeChecked: false,
+		strict: false,
+		stylistic: true
+	};
+	return {
+		typeChecked: options.typeChecked ?? false,
+		strict: options.strict ?? false,
+		stylistic: options.stylistic ?? true,
+		projectService: options.projectService
+	};
+}
+const typescript = (options = true) => {
+	const opts = resolveTypeScriptOptions(options);
+	const baseline = opts.strict && opts.typeChecked ? ts.configs.strictTypeChecked : opts.strict ? ts.configs.strict : opts.typeChecked ? ts.configs.recommendedTypeChecked : ts.configs.recommended;
+	const stylistic = opts.stylistic ? opts.typeChecked ? ts.configs.stylisticTypeChecked : ts.configs.stylistic : [];
+	const enableProjectService = opts.projectService ?? (opts.typeChecked ? true : void 0);
+	return [
+		...baseline,
+		...stylistic,
+		{
+			files: [GLOB_TS, GLOB_TSX],
+			name: "heyq02/typescript",
+			...enableProjectService === void 0 ? {} : { languageOptions: { parserOptions: { projectService: enableProjectService } } },
+			rules: {
+				"@typescript-eslint/ban-ts-comment": "off",
+				"@typescript-eslint/consistent-type-assertions": ["error", {
+					assertionStyle: "as",
+					objectLiteralTypeAssertions: "allow-as-parameter"
+				}],
+				"@typescript-eslint/consistent-type-imports": ["error", {
+					disallowTypeAnnotations: false,
+					fixStyle: "inline-type-imports"
+				}],
+				"@typescript-eslint/method-signature-style": ["error", "property"],
+				"@typescript-eslint/no-empty-object-type": "off",
+				"@typescript-eslint/no-explicit-any": "off",
+				"@typescript-eslint/no-import-type-side-effects": "error",
+				"@typescript-eslint/no-non-null-assertion": "off",
+				"@typescript-eslint/no-redeclare": "error",
+				"@typescript-eslint/no-unused-expressions": ["error", {
+					allowShortCircuit: true,
+					allowTaggedTemplates: true,
+					allowTernary: true
+				}],
+				"@typescript-eslint/no-unused-vars": ["error", {
+					args: "after-used",
+					argsIgnorePattern: "^_",
+					ignoreRestSiblings: true,
+					varsIgnorePattern: "^_"
+				}],
+				"@typescript-eslint/no-useless-constructor": "error",
+				"@typescript-eslint/prefer-as-const": "warn",
+				"@typescript-eslint/prefer-literal-enum-member": ["error", { allowBitwiseExpressions: true }],
+				"no-restricted-syntax": [
+					"error",
+					...restrictedSyntaxJs,
+					"TSEnumDeclaration[const=true]"
+				],
+				"no-unused-vars": "off"
+			}
+		},
+		{
+			files: ["**/*.d.ts"],
+			name: "heyq02/typescript/dts-rules",
+			rules: {
+				"import/no-duplicates": "off",
+				"no-restricted-syntax": "off"
+			}
+		},
+		{
+			files: [GLOB_JS, "**/*.cjs"],
+			name: "heyq02/typescript/cjs-rules",
+			rules: { "@typescript-eslint/no-require-imports": "off" }
+		}
+	];
+};
+//#endregion
+//#region src/configs/unicorn.ts
+const unicorn = () => [{
+	...unicornPlugin.configs.recommended,
+	files: [GLOB_SRC],
+	name: "heyq02/unicorn/recommended"
+}, {
+	files: [GLOB_SRC],
+	name: "heyq02/unicorn",
+	rules: {
+		"unicorn/filename-case": ["error", {
+			cases: {
+				kebabCase: true,
+				pascalCase: true
+			},
+			ignore: [
+				String.raw`^[A-Z]+\..*$`,
+				String.raw`^[a-z]{2}-[A-Z]{2}$`,
+				String.raw`import_map\.json`
+			]
+		}],
+		"unicorn/no-null": "off",
+		"unicorn/no-this-assignment": "off",
+		"unicorn/prefer-ternary": "off",
+		"unicorn/no-process-exit": "off"
+	}
+}];
+//#endregion
+//#region src/env.ts
+const require = createRequire(import.meta.url);
+const cwd = process.cwd();
+function isPackageExists(name) {
+	try {
+		require.resolve(name, { paths: [cwd] });
+		return true;
+	} catch {
+		return false;
+	}
+}
+const hasTypeScript = () => isPackageExists("typescript");
+const hasReact = () => isPackageExists("react") || isPackageExists("react-dom") || isPackageExists("next") || isPackageExists("preact") || isPackageExists("@remix-run/react");
+const hasJest = () => isPackageExists("jest") || isPackageExists("@jest/globals");
+const hasRstest = () => isPackageExists("rstest") || isPackageExists("@rstest/core") || isPackageExists("@rstest/adapter");
+function isInEditorEnv() {
+	if (process.env.CI) return false;
+	if (isInGitHooksOrLintStaged()) return false;
+	return !!(process.env.VSCODE_PID || process.env.VSCODE_CWD || process.env.JETBRAINS_IDE || process.env.VIM || process.env.NVIM);
+}
+function isInGitHooksOrLintStaged() {
+	return !!(process.env.GIT_PARAMS || process.env.VSCODE_GIT_COMMAND || process.env.npm_lifecycle_script?.startsWith("lint-staged"));
+}
+//#endregion
+//#region src/utils.ts
+/** Flatten nested config values into a single entry list. */
+function flattenConfigs(...configs) {
+	const result = [];
+	for (const config of configs) {
+		if (!config) continue;
+		if (Array.isArray(config)) {
+			result.push(...flattenConfigs(...config));
+			continue;
+		}
+		result.push(config);
+	}
+	return result;
+}
+function toArray(value) {
+	return Array.isArray(value) ? value : [value];
+}
+//#endregion
+//#region src/presets.ts
+/** Ignore common files and include JavaScript support. */
+const presetJavaScript = () => [
+	...ignores(),
+	...javascript(),
+	...imports({ typescript: false }),
+	...unicorn(),
+	...node(),
+	...promise()
+];
+/** Includes `presetJavaScript` and TypeScript support. */
+const presetBasic = (typescriptOptions = true) => [
+	...ignores(),
+	...javascript(),
+	...typescript(typescriptOptions),
+	...imports({ typescript: true }),
+	...unicorn(),
+	...node(),
+	...promise()
+];
+/**
+* Full opinionated preset:
+* - JS + TS
+* - Unicorn / import / node / promise
+* - React / Jest / Rstest when detected
+* - Special-case overrides
+*/
+const presetAll = () => heyq02({
+	typescript: true,
+	react: true,
+	jest: true,
+	rstest: true,
+	jsxA11y: true
+});
+/**
+* `@heyq02`'s opinionated Rslint config preset.
+*
+* @example
+* ```ts
+* // rslint.config.ts
+* import { heyq02 } from '@heyq02/rslint-config'
+*
+* export default heyq02({
+*   typescript: { typeChecked: true, strict: true },
+*   react: true,
+* })
+* ```
+*/
+function heyq02(options = {}, ...userConfigs) {
+	const { ignores: extraIgnores = [], javascript: enableJavaScript = true, typescript: enableTypeScript = hasTypeScript(), unicorn: enableUnicorn = true, imports: enableImports = true, node: enableNode = true, promise: enablePromise = true, react: enableReact = hasReact(), jsxA11y: enableJsxA11y, jest: enableJest = hasJest(), rstest: enableRstest = hasRstest() } = options;
+	const configs = [...ignores(extraIgnores)];
+	if (enableJavaScript) configs.push(...javascript());
+	if (enableTypeScript) configs.push(...typescript(enableTypeScript === true ? true : enableTypeScript));
+	if (enableImports) configs.push(...imports({ typescript: Boolean(enableTypeScript) }));
+	if (enableUnicorn) configs.push(...unicorn());
+	if (enableNode) configs.push(...node(enableNode === true ? "module" : enableNode));
+	if (enablePromise) configs.push(...promise());
+	if (enableReact) configs.push(...react({ jsxA11y: enableJsxA11y ?? true }));
+	else if (enableJsxA11y) configs.push(...jsxA11y());
+	if (enableJest) configs.push(...jest());
+	if (enableRstest) configs.push(...rstest());
+	configs.push(...specialCases());
+	configs.push(...flattenConfigs(...userConfigs));
+	return configs;
+}
+/** Alias of {@link heyq02}. */
+const rslintConfig = heyq02;
+//#endregion
+export { GLOB_DIST, GLOB_EXCLUDE, GLOB_JS, GLOB_JSX, GLOB_LOCKFILE, GLOB_NODE_MODULES, GLOB_SRC, GLOB_SRC_EXT, GLOB_TESTS, GLOB_TS, GLOB_TSX, flattenConfigs, hasJest, hasReact, hasRstest, hasTypeScript, heyq02, ignores, imports, isInEditorEnv, isInGitHooksOrLintStaged, javascript, jest, jsxA11y, node, presetAll, presetBasic, presetJavaScript, promise, react, restrictedSyntaxJs, rslintConfig, rstest, specialCases, toArray, typescript, unicorn };

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@heyq02/rslint-config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.0",
+  "description": "Opinionated Rslint flat-config preset.",
+  "keywords": [
+    "flat-config",
+    "lint",
+    "rslint",
+    "rslint-config",
+    "typescript"
+  ],
+  "homepage": "https://github.com/heyq02/rslint-config#readme",
+  "bugs": {
+    "url": "https://github.com/heyq02/rslint-config/issues"
+  },
+  "license": "MIT",
+  "author": "Ari <mail@heyq02.cn>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/heyq02/rslint-config.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@rslint/core": "^0.9.4",
+    "@types/node": "^26.1.1",
+    "bumpp": "^11.1.0",
+    "typescript": "^7.0.2",
+    "vite-plus": "1.0.0"
+  },
+  "peerDependencies": {
+    "@rslint/core": "^0.9.0"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "12.10.1",
+      "onFail": "download"
+    }
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "echo Skip",
+    "check": "vp check",
+    "lint": "rslint .",
+    "lint:fix": "rslint --fix .",
+    "format": "vp fmt",
+    "typecheck": "vp check --no-fmt --no-lint",
+    "release": "bumpp"
+  }
 }