drccrd commented on code in PR #3717: URL: https://github.com/apache/incubator-kie-tools/pull/3717#discussion_r3805973812
########## packages/drl-vscode-extension/README.md: ########## @@ -53,11 +53,71 @@ Language support for [DRL (Drools Rule Language)](https://kie.apache.org/docs/10 - Hover tooltips for DRL/Java types with doc-comment rendering - Reference-count code lens for DRL declared types +## File Grouping + +Scopes completion, navigation and validation to the files a rule compiles with, so `declare` types, imports, functions and `global` declarations resolve across the group. Resolved in this order: + +1. The `drools.lsp.grouping` setting +2. `drl-lsp-kbases.json` anywhere in the workspace — same content as the setting, for committed grouping +3. `META-INF/kmodule.xml` — the `packages` and `includes` attributes the build already uses +4. The containing directory of the active file, if none of the above + +Changes apply without a restart. The status bar shows the active group, and pins one when a file matches several; pins persist per workspace, and the tooltip names the declaring file. Groups from a `kmodule.xml` show as **KIE base**, all others as **DRL group**. + +### Declaring groups + +Use `packages`/`includes` for `kmodule.xml` semantics, or `files` for an explicit ordered list. Relative paths resolve against the workspace root in the setting, against the file's own directory in `drl-lsp-kbases.json`. + +```json +{ + "kbases": [ + { + "name": "validation", + "packages": ["!com.example.validation.internal.*", "com.example.validation.*"], + "includes": ["shared"] + }, + { "name": "legacy", "files": ["rules/Types.drl", "rules/Enums.drl"] } + ] +} +``` + +> In `packages`, the first matching pattern decides — including its sign. List exclusions before the wildcard they carve out of. + +### Adopting an existing manifest + +`sources` allows rule group definitions with alternate syntax. `aliases` maps each canonical key to the key(s) to alternates; several may collapse onto one. Review Comment: Fixed in c91af962d8d4d08edc64cbcc2d26f7c5e3297319 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
