feat(eslint-config): enable lessOpinionated with top-level-function

- Set `lessOpinionated: true` to use `curly: ['error', 'all']` instead
  of antfu's brace-omitting style
- Re-enable `antfu/top-level-function` for function declarations
- Add explicit `Linter.Config` type annotation in package-json.ts to
  fix build error from jsonc-eslint-parser reference
- Update README FAQ and defaults table

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: amondnet

packages/eslint-config/README.md

@@ -24,6 +24,8 @@ This config wraps `@antfu/eslint-config` with the following defaults:
 | Semicolons | No |
 | TypeScript | Enabled |
 | Gitignore | Enabled |
+| `lessOpinionated` | `true` — disables `antfu/if-newline` and `antfu/curly`, enables `curly: ['error', 'all']` |
+| `antfu/top-level-function` | Re-enabled — prefer `function` declarations at top level |
 
 Additionally, `test/prefer-lowercase-title` is disabled.
 
@@ -376,6 +378,35 @@ This config inherits `@antfu/eslint-config`'s plugin renaming for a consistent D
 | `style/*` | `@stylistic/*` | [@stylistic/eslint-plugin](https://github.com/eslint-stylistic/eslint-stylistic) |
 | `test/*` | `vitest/*` | [@vitest/eslint-plugin](https://github.com/vitest-dev/eslint-plugin-vitest) |
 
+## FAQ
+
+### Prettier?
+
+This config uses ESLint for both linting and formatting, so Prettier is not needed. See [Why I don't use Prettier](https://antfu.me/posts/why-not-prettier) by Anthony Fu.
+
+If you need to format files that ESLint cannot handle yet (`.css`, `.html`, etc.), use the [formatters](#formatters) option instead.
+
+### How to format CSS?
+
+You can opt-in to the [`formatters`](#formatters) feature to format your CSS. Note that it only does formatting, not linting. If you want proper linting support, give [`stylelint`](https://stylelint.io/) a try.
+
+### Curly braces style?
+
+PleaseAI defaults to `lessOpinionated: true`, which enforces `curly: ['error', 'all']` — always require braces around control flow bodies:
+
+```js
+// PleaseAI style
+if (foo) {
+  return
+}
+
+// NOT this (antfu default)
+if (foo)
+  return
+```
+
+Note: `antfu/top-level-function` is re-enabled, so top-level `function` declarations are still preferred over arrow functions.
+
 ## Re-exports
 
 All exports from `@antfu/eslint-config` are re-exported, so you can import fine-grained configs directly:

packages/eslint-config/src/index.ts

@@ -7,6 +7,7 @@ export function pleaseai(
 ): ReturnType<typeof antfu> {
   return antfu(
     {
+      lessOpinionated: true,
       stylistic: {
         indent: 2,
         quotes: 'single',
@@ -15,6 +16,7 @@ export function pleaseai(
       typescript: true,
       gitignore: true,
       rules: {
+        'antfu/top-level-function': 'error',
         'test/prefer-lowercase-title': 'off',
       },
       ...options,

packages/eslint-config/src/package-json.ts

@@ -1,6 +1,7 @@
+import type { Linter } from 'eslint'
 import packageJson from 'eslint-plugin-package-json'
 
-export const recommended = packageJson.configs['recommended-publishable']
-export const stylistic = packageJson.configs.stylistic
+export const recommended: Linter.Config = packageJson.configs['recommended-publishable']
+export const stylistic: Linter.Config = packageJson.configs.stylistic
 
 export default recommended