feat(QTDI-2862): Add watch() attribute to @FixedSchema

[thboileau]

Requirements

• Any code change adding any logic MUST be tested through a unit test executed with the default build
• Any API addition MUST be done with a documentation update if relevant

Why this PR is needed?

QTDI-2862 — The @FixedSchema annotation currently offers no way to tell Studio which configuration parameters should trigger an automatic schema refresh. Without this, Studio cannot know when the fixed schema may have changed (e.g. when the user selects a different dataset or changes a connection URL), and the schema is never refreshed dynamically.

What does this PR add (design/code thoughts)?

Adds a new optional watch() attribute to @FixedSchema accepting parameter path strings in the same dot-notation as @Updatable#parameters().

• component-api — FixedSchema.java: new String[] watch() default {} attribute with Javadoc.
• component-runtime-manager — ComponentSchemaEnricher.java: new constant FIXED_SCHEMA_WATCH_META_PREFIX = "tcomp::ui::schema::fixed::watch". When watch() is non-empty, the enricher emits the comma-joined paths under this key. When empty (default), the key is not emitted — full backward compatibility.
• ComponentSchemaEnricherTest.java: 3 new unit tests covering single path, multiple paths (comma-joined), and empty watch() (key absent).
• studio-schema.adoc: documents all three @FixedSchema attributes in a reference table.

Studio-side wiring (ElementParameterCreator + IValueChangedListener) is out of scope for this PR and will be handled in a follow-up ticket in the Studio repository.

AI generated code

https://internal.qlik.dev/general/ways-of-working/code-reviews/#guidelines-for-ai-generated-code

• this PR has been written with the help of GitHub Copilot or another generative AI tool

[thboileau]

Scope & Design Review — QTDI-2862

Verdict: ✅ No findings — implementation matches spec exactly.

Scope check

• All changes are confined to the 4 files listed in the plan: FixedSchema.java, ComponentSchemaEnricher.java, ComponentSchemaEnricherTest.java, studio-schema.adoc.
• No Studio-side wiring attempted (correctly deferred to follow-up).
• Backward compatibility preserved: watch() defaults to {} → key not emitted when empty.

Design check

• Metadata key tcomp::ui::schema::fixed::watch follows the established tcomp::ui::schema::* naming convention.
• Path format (dot-notation, comma-joined) is consistent with @Updatable#parameters() / FIXED_SCHEMA_FLOWS_META_PREFIX.
• No validation of paths against declared @Options — intentionally out of scope (same posture as @Updatable).

Compliance check

• ✅ No wildcard imports
• ✅ Spotless applied before commit
• ✅ No new Sonar-triggerable patterns (no unused params, no generic catches, no public on @Test)
• ✅ Javadoc present on new API method
• ✅ Documentation updated

---

Generated by GitHub Copilot agent — 2026-07-17

[sonar-rnd]

Quality Gate passed

Issues

• 0 New Issues
• 0 Fixed Issues
• 0 Accepted Issues

Measures

• 0 Security Hotspots
• 0.00% Coverage (0.00% Estimated after merge)
• 0.00% Duplicated Code (1.50% Estimated after merge)

Project ID: org.talend.sdk.component:component-runtime

View in SonarQube