fix(eslint): improve JSDoc config for TS (#317)

## Summary

Improved JSDoc ESLint configuration to better support TypeScript
projects by using TypeScript-specific recommended rules and adding
explicit file targeting.

## Changes

- Switched from `flat/recommended` to `flat/recommended-typescript`
config
- Added explicit file targeting with `GLOB_JS` and `GLOB_TS`
- Removed `jsdoc/no-restricted-syntax` rule
- Updated `jsdoc/require-jsdoc` to not require JSDoc on
ArrowFunctionExpression or FunctionDeclaration

## Motivation

The previous configuration used generic JSDoc recommended rules which
were not optimized for TypeScript. The TypeScript-specific preset
provides better defaults for TypeScript projects. Additionally,
requiring JSDoc on arrow functions (which are more commonly used in
modern codebases) while making it optional for function declarations
provides better documentation coverage without being overly restrictive.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Style**
  * Switched JSDoc linting to a TypeScript-focused baseline.
* JSDoc is no longer required on arrow functions or function
declarations.
  * Removed a restrictive JSDoc syntax rule.

* **Chores**
  * Improved JavaScript/TypeScript file targeting in lint configuration.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: mheob

.changeset/whole-cobras-knock.md

@@ -0,0 +1,9 @@
+---
+'@mheob/eslint-config': patch
+---
+
+Updated JSDoc rules:
+- Added explicit file targeting with GLOB_JS and GLOB_TS
+- Switched from flat/recommended to flat/recommended-typescript config
+- Removed jsdoc/no-restricted-syntax rule
+- Updated jsdoc/require-jsdoc to not require JSDoc on ArrowFunctionExpression or FunctionDeclaration

.claude/commands/create-commit.md

@@ -12,7 +12,7 @@ description: Create a git commit
 
 ## Your tasks
 
-- create changeset if needed (at least an empty changeset); write the change message in a full sentence
+- create changeset if needed (at least an empty changeset); don't write the change message too short
 - create a single git commit based on the above changes
 
 Use conventional commits with a title length of max 50 characters. See @commitlint.config.js for more details.

packages/eslint-config/src/configs/jsdoc.ts

@@ -1,3 +1,4 @@
+import { GLOB_JS, GLOB_TS } from '../globs';
 import type { TypedFlatConfigItem } from '../types';
 import { interopDefault } from '../utils';
 
@@ -6,28 +7,31 @@ import { interopDefault } from '../utils';
  *
  * This function sets up the necessary ESLint plugin for JSDoc,
  * including the `eslint-plugin-jsdoc`. It also configures the rules for JSDoc,
- * including the recommended rules, no-restricted-syntax, reject-any-type,
- * reject-function-type, require-jsdoc, require-next-type, and tag-lines rules.
+ * including the recommended rules, reject-any-type, reject-function-type, require-jsdoc,
+ * require-next-type, and tag-lines rules.
  *
  * @returns Promise that resolves once the JSDoc ESLint rules are configured.
  */
 export async function jsdoc(): Promise<TypedFlatConfigItem[]> {
 	const jsdocPlugin = await interopDefault(import('eslint-plugin-jsdoc'));
-	const recommendedRules = jsdocPlugin.configs['flat/recommended'].rules;
+	const recommendedRules = jsdocPlugin.configs['flat/recommended-typescript'].rules;
 
 	return [
 		{
+			files: [GLOB_JS, GLOB_TS],
 			name: 'mheob/jsdoc/rules',
 			plugins: {
 				jsdoc: jsdocPlugin,
 			},
 			rules: {
 				...recommendedRules,
 
-				'jsdoc/no-restricted-syntax': 'warn',
 				'jsdoc/reject-any-type': 'warn',
 				'jsdoc/reject-function-type': 'warn',
-				'jsdoc/require-jsdoc': 'warn',
+				'jsdoc/require-jsdoc': [
+					'warn',
+					{ require: { ArrowFunctionExpression: false, FunctionDeclaration: false } },
+				],
 				'jsdoc/require-next-type': 'warn',
 				'jsdoc/tag-lines': ['warn', 'always', { count: 0, startLines: 1 }],
 			},