name: forms-mode-transitions description: Detailed guidance for FormsManager mode transitions in BeepDM. Use when working with EnterQueryModeAsync, ExecuteQueryAndEnterCrudModeAsync, EnterCrudModeForNewRecordAsync, and related readiness or validation checks across blocks.

Forms Mode Transitions

Use this skill when implementing or debugging mode-aware behavior in FormsManager.

File Locations

• DataManagementEngineStandard/Editor/Forms/FormsManager.ModeTransitions.cs
• DataManagementEngineStandard/Editor/Forms/FormsManager.EnhancedOperations.cs
• DataManagementEngineStandard/Editor/Forms/Helpers/DirtyStateManager.cs

Core APIs

• EnterQueryModeAsync(...)
• ExecuteQueryAndEnterCrudModeAsync(...)
• EnterCrudModeForNewRecordAsync(...)
• CreateNewRecordInMasterBlockAsync(...)
• ValidateAllBlocksForModeTransitionAsync()
• GetBlockMode(...)
• GetAllBlockModeInfo()
• IsFormReadyForModeTransitionAsync()

Working Rules

1. Never force mode changes by mutating block state externally.
2. Always inspect returned IErrorsInfo.
3. Resolve unsaved changes and parent context before entering detail CRUD flows.
4. Preserve status updates and event-trigger semantics around transitions.

Related Skills

• forms
• forms-enhanced-data-operations
• forms-helper-managers

Detailed Reference

Use reference.md for transition flows, failure patterns, and debug checks.