@ximatai/muyun-web-app 0.26.10 → 0.26.12

package/dist/types/dynamic-page-runtime/composables/useNavigatorRuntime.d.ts

@@ -3,11 +3,19 @@ import { type QueryListRecord, type RecordFormFieldDescriptor } from '../../plat
 import type { ResolvedModuleUiDescriptor, ResolvedModulePageDescriptor, ResolvedPageContextBindingDescriptor, ResolvedPageNavigatorLevelDescriptor, RouteQueryValue } from '../../web-contracts/index';
 import { type HttpClient, type ModuleContext } from '../../web-core/index';
 import { type NavigatorEntrySelection } from '../navigatorEntrySelection';
+export interface NavigatorSortViewState {
+    visible: boolean;
+    enabled: boolean;
+    active?: boolean;
+    disabledReason?: string;
+}
 /** Runtime state that belongs to the page/navigator session rather than to a Vue host. */
 export interface NavigatorLevelRuntime {
     descriptor: ResolvedPageNavigatorLevelDescriptor;
     context: ModuleContext<QueryListRecord>;
     tree: boolean;
+    /** Resolved navigator actions consumed by the page surfaces. */
+    sort: NavigatorSortViewState;
 }
 export interface NavigatorEntrySelectionChange {
     previous?: NavigatorEntrySelection;
@@ -37,7 +45,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -56,7 +64,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -75,7 +83,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -140,6 +148,10 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 required: boolean;
             }[] | undefined;
             titleField?: string | undefined;
+            displayProjections?: {
+                targetField: string;
+                outputField: string;
+            }[] | undefined;
             selectionProjections?: {
                 path: string[];
             }[] | undefined;
@@ -181,7 +193,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -200,7 +212,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -219,7 +231,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -284,6 +296,10 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 required: boolean;
             }[] | undefined;
             titleField?: string | undefined;
+            displayProjections?: {
+                targetField: string;
+                outputField: string;
+            }[] | undefined;
             selectionProjections?: {
                 path: string[];
             }[] | undefined;
@@ -331,7 +347,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -350,7 +366,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -369,7 +385,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -434,6 +450,10 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 required: boolean;
             }[] | undefined;
             titleField?: string | undefined;
+            displayProjections?: {
+                targetField: string;
+                outputField: string;
+            }[] | undefined;
             selectionProjections?: {
                 path: string[];
             }[] | undefined;
@@ -475,7 +495,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -494,7 +514,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -513,7 +533,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -578,6 +598,10 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 required: boolean;
             }[] | undefined;
             titleField?: string | undefined;
+            displayProjections?: {
+                targetField: string;
+                outputField: string;
+            }[] | undefined;
             selectionProjections?: {
                 path: string[];
             }[] | undefined;
@@ -626,7 +650,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -645,7 +669,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -664,7 +688,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -729,6 +753,10 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 required: boolean;
             }[] | undefined;
             titleField?: string | undefined;
+            displayProjections?: {
+                targetField: string;
+                outputField: string;
+            }[] | undefined;
             selectionProjections?: {
                 path: string[];
             }[] | undefined;
@@ -770,7 +798,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -789,7 +817,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -808,7 +836,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -873,6 +901,10 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 required: boolean;
             }[] | undefined;
             titleField?: string | undefined;
+            displayProjections?: {
+                targetField: string;
+                outputField: string;
+            }[] | undefined;
             selectionProjections?: {
                 path: string[];
             }[] | undefined;
@@ -920,7 +952,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -939,7 +971,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -958,7 +990,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -1023,6 +1055,10 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 required: boolean;
             }[] | undefined;
             titleField?: string | undefined;
+            displayProjections?: {
+                targetField: string;
+                outputField: string;
+            }[] | undefined;
             selectionProjections?: {
                 path: string[];
             }[] | undefined;
@@ -1064,7 +1100,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -1083,7 +1119,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -1102,7 +1138,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 expression: string;
                 program?: {
                     schemaVersion: number;
-                    profile: "WEB_UI" | "FORM_COMPUTE";
+                    profile: "WEB_UI" | "PAGE_TEXT" | "FORM_COMPUTE" | "FORM_VALIDATION";
                     root: {
                         kind: "VALUE" | "FIELD" | "OTHERS" | "UNARY" | "BINARY" | "FUNCTION" | "ASSIGN";
                         operator?: string | undefined;
@@ -1167,6 +1203,10 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 required: boolean;
             }[] | undefined;
             titleField?: string | undefined;
+            displayProjections?: {
+                targetField: string;
+                outputField: string;
+            }[] | undefined;
             selectionProjections?: {
                 path: string[];
             }[] | undefined;
@@ -1219,7 +1259,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
             sourceScope?: "NONE" | "CURRENT_TENANT" | undefined;
             management?: {
                 editorSurface?: string | undefined;
-            } | undefined;
+            } | null | undefined;
         };
         context: {
             moduleAlias: string;
@@ -1235,6 +1275,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 delete: (id: string, request: import("../../web-core/index").RecordActionRequest) => Promise<import("../../web-core/index").StaticCountMutationResult>;
                 enable: (id: string, request: import("../../web-core/index").RecordActionRequest) => Promise<import("../../web-core/index").StaticCountMutationResult>;
                 disable: (id: string, request: import("../../web-core/index").RecordActionRequest) => Promise<import("../../web-core/index").StaticCountMutationResult>;
+                sort?: ((id: string, request: import("../../web-contracts/index").SortRequest) => Promise<import("../../web-core/index").StaticCountMutationResult>) | undefined;
             };
             runtime: {
                 ready: {
@@ -1276,6 +1317,12 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
             invalidateRecordActions?: ((recordIds?: string[]) => void) | undefined;
         };
         tree: boolean;
+        sort: {
+            visible: boolean;
+            enabled: boolean;
+            active?: boolean | undefined;
+            disabledReason?: string | undefined;
+        };
     }[], NavigatorLevelRuntime[] | {
         descriptor: {
             key: string;
@@ -1289,7 +1336,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
             sourceScope?: "NONE" | "CURRENT_TENANT" | undefined;
             management?: {
                 editorSurface?: string | undefined;
-            } | undefined;
+            } | null | undefined;
         };
         context: {
             moduleAlias: string;
@@ -1305,6 +1352,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
                 delete: (id: string, request: import("../../web-core/index").RecordActionRequest) => Promise<import("../../web-core/index").StaticCountMutationResult>;
                 enable: (id: string, request: import("../../web-core/index").RecordActionRequest) => Promise<import("../../web-core/index").StaticCountMutationResult>;
                 disable: (id: string, request: import("../../web-core/index").RecordActionRequest) => Promise<import("../../web-core/index").StaticCountMutationResult>;
+                sort?: ((id: string, request: import("../../web-contracts/index").SortRequest) => Promise<import("../../web-core/index").StaticCountMutationResult>) | undefined;
             };
             runtime: {
                 ready: {
@@ -1346,9 +1394,15 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
             invalidateRecordActions?: ((recordIds?: string[]) => void) | undefined;
         };
         tree: boolean;
+        sort: {
+            visible: boolean;
+            enabled: boolean;
+            active?: boolean | undefined;
+            disabledReason?: string | undefined;
+        };
     }[]>;
     pageContextBindings: Ref<{
-        source: "SESSION" | "NAVIGATOR";
+        source: "SESSION" | "NAVIGATOR" | "RESOLVED_SELECTION";
         sourceKey: string;
         target: "LIST_QUERY" | "NAVIGATOR_QUERY" | "FORM_DEFAULT" | "PICKER_QUERY" | "MUTATION_CONSTRAINT";
         targetKey: string;
@@ -1356,7 +1410,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
         targetPickerFieldKey?: string | undefined;
         navigatorListQueryMode?: "REQUIRED_SCOPE" | "OPTIONAL_FILTER" | undefined;
     }[], ResolvedPageContextBindingDescriptor[] | {
-        source: "SESSION" | "NAVIGATOR";
+        source: "SESSION" | "NAVIGATOR" | "RESOLVED_SELECTION";
         sourceKey: string;
         target: "LIST_QUERY" | "NAVIGATOR_QUERY" | "FORM_DEFAULT" | "PICKER_QUERY" | "MUTATION_CONSTRAINT";
         targetKey: string;

package/dist/types/dynamic-page-runtime/composables/useRecordEditingSession.d.ts

@@ -17,7 +17,7 @@ export declare function useRecordEditingSession<TRecord extends {
     id?: unknown;
 }>(context: ModuleContext<TRecord>, detail: DetailController<TRecord>, onLoaded: () => void): {
     invalidatePendingRequests: () => void;
-    openRecord: (record: TRecord, mode: "edit" | "view", options?: RecordDetailTransitionOptions, skipLoad?: boolean) => Promise<void>;
+    openRecord: (record: TRecord, mode: "edit" | "view", options?: RecordDetailTransitionOptions, skipLoad?: boolean, onLoadError?: (cause: unknown) => void) => Promise<void>;
     openRecycleBinRecord: (record: TRecord) => Promise<void>;
 };
 export {};

package/dist/types/dynamic-page-runtime/formActionResult.d.ts

@@ -0,0 +1,5 @@
+/** Only an explicit form result may update an unsaved draft. Ordinary action data is not a patch. */
+export declare function formActionResult(response: unknown): {
+    recordPatch: Record<string, unknown>;
+    message?: string;
+};

package/dist/types/dynamic-page-runtime/formComputeCoordinator.d.ts

@@ -6,13 +6,16 @@ import type { ResolvedFormComputeRuleDescriptor } from '../web-contracts/index';
  *
  * The coordinator owns propagation, rather than the field component or the
  * FormulaRuntime: fields remain plain inputs and FormulaRuntime remains a
- * pure evaluator. A rule runs at most once in a pass, which makes malformed
- * cyclic descriptor graphs fail closed instead of repeatedly overwriting a
- * user's draft.
+ * pure evaluator. It validates the descriptor graph before evaluating any
+ * rule, then evaluates applicable rules in dependency order.
  */
 export declare class FormComputeCoordinator {
     private readonly runtime;
     private readonly rules;
+    private readonly propagationOrder;
     constructor(rules: readonly ResolvedFormComputeRuleDescriptor[] | undefined, runtime?: FormulaRuntime);
-    applyAfterChange<TDraft extends FormulaRecord>(draft: TDraft, changedFields: readonly string[]): TDraft;
+    applyAfterChange<TDraft extends FormulaRecord>(draft: TDraft, changedFields: readonly string[], childAggregateRows?: FormulaRecord): TDraft;
+    /** Evaluate computed fields once when a new form opens, including constant expressions. */
+    applyOnCreate<TDraft extends FormulaRecord>(draft: TDraft, childAggregateRows?: FormulaRecord): TDraft;
+    private evaluate;
 }

package/dist/types/dynamic-page-runtime/formValidationCoordinator.d.ts

@@ -0,0 +1,17 @@
+import { FormulaRuntime, type FormulaRecord } from '../formula/FormulaRuntime';
+import type { ResolvedFormValidationRuleDescriptor } from '../web-contracts/index';
+export type FormValidationFailure = Readonly<{
+    code: string;
+    message: string;
+    targetField?: string;
+}>;
+/**
+ * Executes only descriptors that have already passed server projection. Invalid descriptor shapes
+ * fail open, preserving the server mutation boundary as the final authority.
+ */
+export declare class FormValidationCoordinator {
+    private readonly runtime;
+    private readonly rules;
+    constructor(rules: readonly ResolvedFormValidationRuleDescriptor[] | undefined, runtime?: FormulaRuntime);
+    validate(draft: FormulaRecord): FormValidationFailure | undefined;
+}

package/dist/types/dynamic-page-runtime/index.d.ts

@@ -1,5 +1,4 @@
 export { default as ModulePageHost } from './ModulePageHost.vue';
-export { default as DynamicModuleHost } from './DynamicModuleHost.vue';
 export { default as DynamicModulePage } from './DynamicModulePage.vue';
 export { default as DynamicModuleWorkspaceDetailView } from './DynamicModuleWorkspaceDetailView.vue';
 export { customerDescriptor } from './mockDescriptor';
@@ -8,4 +7,4 @@ export { provideModulePageNavigation, useModulePageNavigation } from './modulePa
 export { NAVIGATOR_ENTRY_MODULE_ALIAS_QUERY_KEY, NAVIGATOR_ENTRY_RECORD_ID_QUERY_KEY, } from './navigatorEntrySelection';
 export { createModulePageListRefreshRegistry, modulePageListRefreshRegistry, refreshModulePageList, } from './modulePageListRefresh';
 export type { ModulePageListRefreshRegistry } from './modulePageListRefresh';
-export type { ModuleListEnhancement, ModulePageListRowExpansion, ModulePageListRowExpansionContext, ModuleDetailEnhancement, ModulePageFormEnhancement, ModulePageFormContribution, ModulePageFormContributionContext, ModulePageFormContributionState, ModulePageFormFieldPolicy, ModulePageFormContributionLocation, ModulePageFormContributionValidity, ModulePageFormSurface, ModuleCardEnhancement, ModulePageActionContext, ModulePageActionContribution, ModulePageActionStateContext, ModulePageBatchActionContext, ModulePageBatchActionContribution, ModulePageColumnContribution, ModulePageDetailDrawer, ModulePageDetailSection, ModulePageDetailSectionContext, ModulePageDrawer, ModulePageDrawerContext, ModulePageRecordViewContext, ModulePageEnhancement, ModulePageEnhancementActivationContext, ModulePageEnhancementRegistry, ModulePageEnhancementTarget, ModulePageLockedNavigatorEntry, ModulePageCardAssistant, ModulePageCardAssistantContext, ModulePageCardAssistantPlacement, ModulePageRecordActionContext, ModulePageRecordActionContribution, ModulePageScopeContext, ModulePageWorkspaceView, ModulePageWorkspaceViewInput, } from './modulePageEnhancements';
+export type { ModuleListEnhancement, ModulePageListRowExpansion, ModulePageListRowExpansionContext, ModuleDetailEnhancement, ModulePageFormEnhancement, ModulePageFormContribution, ModulePageFormContributionContext, ModulePageFormContributionState, ModulePageFormFieldPolicy, ModulePageFormContributionLocation, ModulePageFormContributionValidity, ModulePageFormSurface, ModuleCardEnhancement, ModulePageActionContext, ModulePageActionContribution, ModulePageActionStateContext, ModulePageBatchActionContext, ModulePageBatchActionContribution, ModulePageColumnContribution, ModulePageDetailDrawer, ModulePageDetailSection, ModulePageDetailSectionContext, ModulePageDrawer, ModulePageDrawerContext, ModulePageRecordViewContext, ModulePageEnhancement, ModulePageEnhancementActivationContext, ModulePageEnhancementRegistry, ModulePageEnhancementTarget, ModulePageNavigatorEnhancement, ModulePageNavigatorTreeParentPolicy, ModulePageNavigatorExtension, ModulePageNavigatorExtensionContext, ModulePageNavigatorSelection, ModulePageLockedNavigatorEntry, ModulePageCardAssistant, ModulePageCardAssistantContext, ModulePageCardAssistantPlacement, ModulePageRecordActionContext, ModulePageRecordActionContribution, ModulePageScopeContext, ModulePageWorkspaceView, ModulePageWorkspaceViewInput, } from './modulePageEnhancements';

package/dist/types/dynamic-page-runtime/modulePageEnhancements.d.ts

@@ -1,5 +1,5 @@
 import type { Component } from 'vue';
-import type { CurrentUser, PageDescriptor, PageLayoutMode, RouteQueryValue, WebQueryCondition } from '../web-contracts/index';
+import type { CurrentUser, PageDescriptor, PageLayoutMode, RouteQueryValue, WebPageResponse, WebQueryCondition, WebQueryRequest } from '../web-contracts/index';
 import type { ModuleContext } from '../web-core/index';
 import type { RecordActionItem, RecordFormFieldState, RecordFormFieldValue, RecordQueryListColumn, QueryListRecord } from '../platform-components/index';
 import type { DrawerTitleAction } from '../platform-components/index';
@@ -20,6 +20,13 @@ export interface ModulePageEnhancement {
      */
     activate?(context: ModulePageEnhancementActivationContext): void | (() => void);
     list?: ModuleListEnhancement;
+    /**
+     * Business record actions shown by default in both the list-row "more"
+     * menu and the standard detail drawer operation area. Use the surface-local
+     * `list.rowActions` or `detail.actions` only when an action is intentionally
+     * limited to one presentation.
+     */
+    recordActions?: ModulePageRecordActionContribution[];
     detail?: ModuleDetailEnhancement;
     /**
      * Frontend-owned editor content mounted at a typed standard-form boundary.
@@ -48,6 +55,17 @@ export interface ModulePageStandardActionsEnhancement {
 export interface ModulePageNavigatorEnhancement {
     /** Hides descriptor navigators when this entry is not navigated by their business scope. */
     hidden?: boolean;
+    /** Business-owned parent admission for a navigator tree; sibling sorting remains standard. */
+    treeParentPolicy?: ModulePageNavigatorTreeParentPolicy;
+    /**
+     * One application-owned navigator surface mounted beside descriptor navigators.
+     *
+     * This is intentionally a single region: the page runner retains layout,
+     * record querying and mutation ownership. An extension may render an
+     * authorized business range selector, but it cannot replace the standard
+     * list or declare executable page context.
+     */
+    extension?: ModulePageNavigatorExtension;
     /** Declares one navigator as an entry-owned, immutable page context. */
     lockedEntry?: ModulePageLockedNavigatorEntry;
     /** Allows the standard list to load without navigator-derived list criteria. */
@@ -58,6 +76,51 @@ export interface ModulePageNavigatorEnhancement {
      */
     emptyListScope?(context: ModulePageEmptyNavigatorScopeContext): readonly WebQueryCondition[] | undefined;
 }
+export interface ModulePageNavigatorTreeParentPolicy {
+    canUseAsParent(record: Readonly<Record<string, unknown>>): boolean;
+    rejectionMessage: string;
+}
+export interface ModulePageNavigatorExtension {
+    key: string;
+    /** Frontend-owned component; backend descriptors never select a component. */
+    component: Component;
+    /**
+     * Optional opaque selection channel owned by the standard page host.
+     *
+     * A navigator extension may select only a declared `key`; the host serializes
+     * the `{ kind, key }` pair into its controlled request header. Extensions
+     * never receive a mutable query map or mutation payload.
+     */
+    selection?: ModulePageNavigatorSelection;
+}
+export interface ModulePageNavigatorSelection {
+    /** Server-registered resolver kind, not a business field name. */
+    kind: string;
+    /** Resolves the first trusted selection before the standard page starts its requests. */
+    initialKey?(currentUser?: CurrentUser): string | undefined;
+    /** Presentation-only copy for the initial trusted selection. It is never sent to the server. */
+    initialPresentation?(currentUser?: CurrentUser): ModulePageSelectionPresentation | undefined;
+}
+/** The only display facts a navigator extension may contribute to PAGE_TEXT. */
+export interface ModulePageSelectionPresentation {
+    label: string;
+    secondaryLabel?: string;
+}
+/** Deliberately small host context for one navigator extension surface. */
+export interface ModulePageNavigatorExtensionContext {
+    moduleAlias: string;
+    /** Current opaque selection key, if this extension declared a selection channel. */
+    selectionKey?: string;
+    /**
+     * Replaces the extension's opaque selection key and reloads the standard
+     * list. The host owns header serialization and every CRUD request.
+     */
+    selectSelectionKey(key: string, presentation?: ModulePageSelectionPresentation): void;
+    /** Reloads only the standard list while retaining the platform-owned query state. */
+    refreshList(): void;
+    /** Reloads the page's standard record surfaces. */
+    reload(): void;
+}
 export interface ModulePageLockedNavigatorEntry {
     /** Descriptor navigator key whose selection is supplied by the page address. */
     navigatorKey: string;
@@ -148,6 +211,8 @@ export interface ModulePageFormContributionContext {
     fields: readonly Readonly<RecordFormFieldState>[];
     /** The field at a field-boundary location, otherwise undefined. */
     field?: Readonly<RecordFormFieldState>;
+    /** Read-only query through the host-owned module context and page scope. */
+    queryRecords(request?: WebQueryRequest): Promise<WebPageResponse<QueryListRecord>>;
     setField(fieldName: string, value: RecordFormFieldValue): void;
     formSessionKey: number;
     /** Reports only this contribution's validation fact to the standard save boundary. */
@@ -278,6 +343,11 @@ export interface ModulePageDrawer {
 }
 /** A business-owned action rendered by the platform in a semantic drawer region. */
 export type ModulePageDrawerAction = DrawerTitleAction;
+/** Facts rendered by the platform-owned fixed operation region of an action drawer. */
+export interface ModulePageDrawerOperation {
+    summary?: string;
+    actions: ModulePageDrawerAction[];
+}
 /** Matches the Workbench input boundary; `parse` remains responsible for route-value validation. */
 export type ModulePageWorkspaceViewInput = object;
 /** A business-owned view with stable, serializable identity. */
@@ -306,6 +376,10 @@ export interface ModulePageDrawerContext {
     reload(): void;
     /** Replaces contextual actions beside the drawer title; actions are cleared with the drawer. */
     setTitleActions(actions: ModulePageDrawerAction[]): void;
+    /** Replaces the fixed operation-region facts; the host owns their position and responsive layout. */
+    setOperation(operation?: ModulePageDrawerOperation): void;
+    /** Replaces the presentation-only subtitle below the platform-owned drawer title. */
+    setSubtitle(subtitle?: string): void;
 }
 /**
  * Context for a custom body inside the platform-owned record-view shell.

package/dist/types/dynamic-page-runtime/pageActionInvocation.d.ts

@@ -0,0 +1,7 @@
+import type { PageActionInvocation } from '../web-contracts/index';
+import type { HttpClient } from '../web-core/index';
+/** Execute only the server-issued transport; action identity is not an HTTP route. */
+export declare function invokePageAction(http: HttpClient, invocation: PageActionInvocation | undefined, context?: {
+    recordId?: string;
+    record?: Record<string, unknown>;
+}): Promise<unknown>;

package/dist/types/dynamic-page-runtime/pageActionPlacement.d.ts

@@ -0,0 +1,14 @@
+import type { RecordActionItem } from '../platform-components/index';
+import type { ResolvedPageActionDescriptor } from '../web-contracts/index';
+/** Placements choose presentation; execution must already have a platform workflow or issued action block. */
+export declare function resolvePlacedPageActions(placements: ResolvedPageActionDescriptor[], anchor: ResolvedPageActionDescriptor['anchor'], actionOf: (code: string) => {
+    actionCode: string;
+    title?: string;
+    actionLevel?: string;
+    category?: string;
+    executorType?: string;
+    formSupported?: boolean;
+    bindingPending?: boolean;
+} | undefined, detailActions: RecordActionItem[], mode: 'create' | 'edit' | 'view', managed?: boolean, record?: {
+    enabled?: unknown;
+}): RecordActionItem[];

package/dist/types/dynamic-page-runtime/recordMutationPayload.d.ts

@@ -0,0 +1,3 @@
+import type { RecordFormRecord } from '../platform-components/index';
+/** Platform write fields are flat; dot keys belong to read-model reference projections. */
+export declare function recordMutationPayload(record: RecordFormRecord): RecordFormRecord;

package/dist/types/formula/FormulaRuntime.d.ts

@@ -12,16 +12,25 @@ export interface FormulaComputeResult {
  */
 export declare class FormulaRuntime {
     evaluateWebUi(program: FormulaProgram | undefined, record: FormulaRecord): boolean;
+    /** Evaluates a server-issued PAGE_TEXT program against a host-whitelisted display context. */
+    evaluatePageText(program: FormulaProgram | undefined, context: FormulaRecord): string | undefined;
     /**
      * Evaluates one server-issued FORM_COMPUTE assignment against a draft without mutating it.
      * Applying the returned patch, ordering rules, and user-value ownership remain form-runtime concerns.
      */
     evaluateFormCompute(program: FormulaProgram | undefined, draft: FormulaRecord, targetValueType?: ViewFieldValueType): FormulaComputeResult;
+    /**
+     * Evaluates one server-issued, read-only form predicate. An invalid descriptor fails open so a
+     * client cannot claim that an unverified rule was enforced; persistence still reaches the
+     * authoritative server validator.
+     */
+    evaluateFormValidation(program: FormulaProgram | undefined, draft: FormulaRecord): boolean | undefined;
     /** Evaluates a row-to-row assignment in the changed row's scope without mutating any drafts. */
     evaluateRelationFormCompute(program: FormulaProgram | undefined, draft: FormulaRecord, targetField: string, targetValueType?: ViewFieldValueType): FormulaComputeResult;
     private evaluateNode;
     private toBoolean;
     private evaluateComputeNode;
+    private evaluatePageTextNode;
 }
 type FormulaValue = string | number | boolean | null | undefined;
 /** Mirrors FormulaEngine.equalsLoose for the primitive values admitted by the WEB_UI profile. */