@xrmforge/devkit 0.7.26 → 0.7.28

package/dist/templates/AGENT.md

@@ -123,6 +123,31 @@ form.$unsafe('estimatedclosedate')?.setValue(closeDate);
 Always use optional chaining (`?.`). The Entity-level Fields Enum ensures the field
 name is valid even though it's not on the form.
 
+**Exception - genuinely cross-entity / cross-form scripts (no single FormTypeInfo fits):**
+
+A script bound to several entities (e.g. a GDPR helper on account/contact/lead) or to several
+forms of one entity where no single form interface carries all the fields cannot use one
+`typedForm<...>`. Then use the RAW `Xrm.FormContext` plus **named constants** (blank logical
+names) for field/control access - this is an accepted pattern, not a workaround:
+
+```typescript
+// constants.ts: named constants with blank logical names (NOT raw inline strings)
+export const ROLE_FIELDS = { Role: 'markant_roleid', Product: 'markant_productid' } as const;
+
+function onChange(ctx: Xrm.Events.EventContext): void {
+  const fc = ctx.getFormContext();                      // raw FormContext, no cast
+  fc.getControl(ROLE_FIELDS.Role)?.setDisabled(true);   // blank name; a runtime variable is fine here
+}
+```
+
+The validate-form gate counts a named constant as compliant (the violation is the raw inline
+string, not the FormContext itself). Use `typedForm` whenever one form interface fits; fall back to
+raw FormContext + named constants for any multi-form script - across entities, or across several
+forms of one entity. For both cases this is the deliberate, supported pattern, not a stopgap. (A
+generated per-entity union FormTypeInfo was considered and deliberately rejected: it would type
+fields the active form may not carry as non-nullable - the false compile-time safety this framework
+exists to prevent. Use named constants + `$unsafe` for nullable access instead.)
+
 ### 2. Fields Enum for ALL getAttribute/getControl AND select() calls
 
 Two types of Fields enums exist:
@@ -344,6 +369,10 @@ form.$context.ui.tabs.get(Tabs.SUMMARYTAB).sections.get(SummarySections.General)
 (form.$context.getControl(Subgrids.Orders) as Xrm.Controls.GridControl).refresh();
 ```
 
+To show/hide a WHOLE section, toggle the section itself via `.sections.get(name).setVisible()`
+(typed through the Sections enum), not each control individually - that is the right tool for
+section-level visibility (F-LMA7-10 typed sections).
+
 ### 12. Notification IDs from NOTIFICATION_IDS
 
 All notification unique IDs must be in `constants.ts`, never inline raw strings:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xrmforge/devkit",
-  "version": "0.7.26",
+  "version": "0.7.28",
   "description": "Build orchestration and project tooling for Dynamics 365 WebResources",
   "keywords": [
     "dynamics-365",