Fix to not display Dao parameter information in the document for elements defined with the for directive.

[xterao]

When generating docs for elements defined by a for directive, if a DAO parameter had the same element name its information was being pulled instead. This change ensures that documentation for for directive elements always refers to the directive’s own definitions, not conflicting DAO parameters.

[Copilot]

Pull Request Overview

This PR fixes the issue where documentation for elements defined with the for directive was incorrectly pulling DAO parameter information. The changes ensure that for directive–defined elements refer solely to their own definitions.

• Updated SQL test file to simulate a for directive element.
• Added a new DAO method to support the test case.
• Modified the DocumentDaoParameterGenerator to bypass DAO parameter lookup when a for directive is present.
• Included a new test in SqlSymbolDocumentTestCase to validate the fix.

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
documentForItemInvalidPrimary.sql	Added SQL test file for verifying that for directive elements use their own definitions.
DocumentTestDao.java	Introduced a new DAO method to support testing of invalid primary parameter documentation.
SqlSymbolDocumentTestCase.kt	Added a test case to ensure the correct documentation text is returned for for directive elements.
DocumentDaoParameterGenerator.kt	Updated parameter lookup logic to skip DAO parameter search when a for directive is detected.

Comments suppressed due to low confidence (2)

src/test/testData/src/main/resources/META-INF/doma/example/dao/document/DocumentTestDao/documentForItemInvalidPrimary.sql:4

• [nitpick] The inline comment in the SQL test contains a caret marker (''). Confirm if this marker is intentional for testing purposes or remove it if it was left accidentally.

name = /* ite<caret>m.name */'name'

src/test/kotlin/org/domaframework/doma/intellij/document/SqlSymbolDocumentTestCase.kt:151

• [nitpick] The test expectation includes a leading space which may be fragile; verify that the intended output should include this whitespace.

val result = " item"