fix: ask KotlinPoet whether a @property name needs backticks

[Marius Volkhart (MariusVolkhart)]

Fixes #247.

formatAsKdocPropertyReference decided whether a KDoc @property name needed backticks with Regex("[A-Za-z_][A-Za-z0-9_]*"), which disagrees with the declaration KotlinPoet renders below it in both directions. café is a plain Kotlin identifier — bare in the declaration, backticked in the tag, which is what the issue reports. Less obviously, object and _ went the other way: bare in the tag, backticked in the declaration.

KotlinPoet escapes a declaration name for four independent reasons — not a legal Java identifier, one of its own reserved KEYWORDS, contains $, or all underscores — and both escapeIfNecessary and the keyword set are internal. A copy of that list here would drift silently on the next KotlinPoet upgrade, so the predicate now renders a throwaway PropertySpec for the name and reads back whether KotlinPoet escaped it. The issue's suggested isJavaIdentifierStart/isJavaIdentifierPart widening would have fixed café and left object, _, and a$b still disagreeing.

The check tests for a backtick anywhere in the rendered text rather than for `name` specifically. KotlinPoet reserves U+00B7 and U+2662 as line-wrapping markers and renders them as spaces, so a name containing one is escaped in the output without appearing there verbatim; matching the name text back read that as "needs no backticks" and emitted a bare, multi-token tag. Names carrying their own backtick are short-circuited before the oracle, since KotlinPoet treats one as already escaped and skips all four checks.

Behavior for a name containing /* or */ (declined outright) and for a name containing a literal backtick is unchanged, as is everything on the SQL-quoting side.

Seven tests in TypeRepositoryTest$PropertyNameKdocDeclarationAgreement assert the @property tag and the val declaration agree in the same rendered file, for café, object, _, a$b, My Col, id, and an interpunct-containing name. No golden file changes; every scenario column name is ASCII.

🤖 Generated with Claude Code

[snyk-io]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues
✅	Licenses	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.