@ximatai/muyun-web-app 0.26.11 → 0.26.13

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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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" | "PAGE_TEXT" | "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,6 +1394,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;
+        };
     }[]>;
     pageContextBindings: Ref<{
         source: "SESSION" | "NAVIGATOR" | "RESOLVED_SELECTION";
@@ -1373,6 +1427,7 @@ export declare function useNavigatorRuntime(context: ModuleContext<QueryListReco
         id?: string;
     }[], externalQueryValues?: Record<string, unknown>) => Promise<NavigatorEntrySelectionResolution | undefined>;
     isCurrentNavigatorEntrySelection: (level: NavigatorLevelRuntime, resolution: NavigatorEntrySelectionResolution) => boolean;
+    loadRuntimeDescriptor: () => Promise<void>;
     loadRuntimeForm: (isListPage: Ref<boolean>, hasBusinessRecordView: () => boolean, fail: (message: string) => void) => Promise<void>;
 };
 export {};

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,7 @@
+/** Distinguishes optional draft diagnostics from actions that declare the patch protocol. */
+export declare function hasFormActionRecordPatch(response: unknown): boolean;
+/** 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,10 +1,12 @@
 export { default as ModulePageHost } from './ModulePageHost.vue';
 export { default as DynamicModulePage } from './DynamicModulePage.vue';
 export { default as DynamicModuleWorkspaceDetailView } from './DynamicModuleWorkspaceDetailView.vue';
+export { default as ModuleReferenceRecordDetailBrowser } from './ModuleReferenceRecordDetailBrowser.vue';
 export { customerDescriptor } from './mockDescriptor';
 export { configureModulePageEnhancementContributions, configureModulePageEnhancements, createModulePageEnhancementRegistry, createReadonlyCardRecordSnapshot, modulePageWorkspaceViews, resolveModulePageEnhancement, } from './modulePageEnhancements';
 export { provideModulePageNavigation, useModulePageNavigation } from './modulePageNavigation';
+export { provideModulePageUnsavedStateHost, useModulePageUnsavedState, type ModulePageUnsavedStateHost, } from './modulePageUnsavedState';
 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, ModulePageNavigatorEnhancement, ModulePageNavigatorExtension, ModulePageNavigatorExtensionContext, ModulePageNavigatorSelection, 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/inputValidationActionStatus.d.ts

@@ -0,0 +1,20 @@
+export type InputValidationTarget = {
+    kind: 'draft';
+    fingerprint: string;
+} | {
+    kind: 'record';
+    recordId: string;
+    fingerprint: string;
+};
+export interface InputValidationAttempt {
+    actionKey: string;
+    target: InputValidationTarget;
+}
+/** Tracks successful validation against the exact input snapshot that was tested. */
+export declare function useInputValidationActionStatus(): {
+    begin: (actionKey: string, target: InputValidationTarget) => InputValidationAttempt;
+    succeed: (attempt: InputValidationAttempt, currentFingerprint?: string) => void;
+    isDraftValidated: (actionKey: string, fingerprint: string | undefined) => boolean;
+    isRecordValidated: (actionKey: string, recordId: string | undefined, fingerprint: string | undefined) => boolean;
+    invalidateRecord: (recordId: string) => void;
+};

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

@@ -1,7 +1,7 @@
 import type { Component } from 'vue';
 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 { DrawerWidth, RecordActionItem, RecordFormFieldState, RecordFormFieldValue, RecordQueryListColumn, QueryListRecord } from '../platform-components/index';
 import type { DrawerTitleAction } from '../platform-components/index';
 /**
  * Frontend-owned, constrained composition for a descriptor-driven module page.
@@ -55,6 +55,8 @@ 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.
      *
@@ -74,6 +76,10 @@ 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. */
@@ -303,6 +309,10 @@ export interface ModulePageBatchActionContribution extends RecordActionItem {
 export interface ModulePageDetailSection {
     key: string;
     title: string;
+    /** Optional heading copy owned by the business section but rendered by the platform shell. */
+    subtitle?: string;
+    /** Reactive subtitle content; receives the same read-only context as the section body. */
+    subtitleComponent?: Component;
     component: Component;
 }
 /** Business content rendered inside the platform-owned standard view drawer. */
@@ -310,7 +320,7 @@ export interface ModulePageDetailDrawer {
     /** The component receives only the documented read-only ModulePageRecordViewContext prop. */
     component: Component;
     /** Keeps the platform drawer shell while allowing dense business views more room. */
-    width?: number | string;
+    width?: DrawerWidth;
     /**
      * Defaults to true. Set false when the business detail body has its own
      * governed read endpoint and only needs the selected list record as context.
@@ -331,7 +341,7 @@ export interface ModulePageCellComponentContribution {
 }
 export interface ModulePageDrawer {
     title: string;
-    width?: number | string;
+    width?: DrawerWidth;
     /** The component receives only the documented ModulePageDrawerContext prop. */
     component: Component;
 }

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

@@ -0,0 +1,10 @@
+/**
+ * Optional host bridge for a dynamic page rendered as an independent workspace
+ * view. The dynamic runtime only reports its local draft fact; the workbench
+ * owns registration, confirmation and tab destruction.
+ */
+export interface ModulePageUnsavedStateHost {
+    registerUnsavedState(source: string, isDirty: () => boolean, isBusy?: () => boolean): () => void;
+}
+export declare function provideModulePageUnsavedStateHost(host: ModulePageUnsavedStateHost | undefined): void;
+export declare function useModulePageUnsavedState(source: string, isDirty: () => boolean, isBusy?: () => boolean): void;

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/recordDetailController.d.ts

@@ -23,6 +23,7 @@ export declare function useRecordDetailController<TRecord extends Record<string,
     saving: import("vue").Ref<boolean, boolean>;
     togglingEnabled: import("vue").Ref<boolean, boolean>;
     formSessionKey: import("vue").Ref<number, number>;
+    isDirty: import("vue").ComputedRef<boolean>;
     beginLoad: (next: TRecord, nextMode: Extract<RecordDetailMode, "edit" | "view">, options?: RecordDetailTransitionOptions) => void;
     resolveLoad: (next: TRecord) => void;
     failLoad: () => void;

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

@@ -0,0 +1,4 @@
+import type { RecordFormRecord } from '../platform-components/index';
+import type { ResolvedViewFieldDescriptor } from '../web-contracts/index';
+/** Read projections never become business writes, including explicitly named flat outputs. */
+export declare function recordMutationPayload(record: RecordFormRecord, fields?: Iterable<Pick<ResolvedViewFieldDescriptor, 'fieldRef' | 'reference' | 'referenceSummary'>>): RecordFormRecord;

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

@@ -0,0 +1,6 @@
+import type { RecordFormFieldDescriptor, RecordFormRecord, ReferenceRecordDetailMutation } from '../platform-components/index';
+/**
+ * Applies published ONE-reference display projections after the referenced
+ * record is saved, without changing the source record's reference value.
+ */
+export declare function applyReferenceRecordProjection(draft: RecordFormRecord, fields: ReadonlyMap<string, RecordFormFieldDescriptor>, mutation: ReferenceRecordDetailMutation): RecordFormRecord;

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

@@ -0,0 +1,3 @@
+import { type WritableComputedRef } from 'vue';
+/** Keep the renderer instance while replacing the disposed business session behind its bindings. */
+export declare function sessionViewBindings<T extends object>(current: () => T): { [K in keyof T]: WritableComputedRef<T[K]>; };

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

@@ -0,0 +1,26 @@
+import { type RecordFormFieldPickerConfig } from '../platform-components/index';
+import type { ResolvedReferenceFieldDescriptor } from '../web-contracts/index';
+import type { ReferenceResolveClient } from '../web-core/index';
+type SourceReferencePickerConfigOptions = {
+    providerScopeKey: string;
+    sourceModuleAlias: string;
+    reference: ResolvedReferenceFieldDescriptor;
+    pickerFieldName: string;
+    referenceResolver: () => ReferenceResolveClient;
+    formValues: () => Record<string, unknown>;
+    reloadRecord: () => Record<string, unknown> | undefined;
+    source: () => {
+        recordId: string;
+    } | undefined;
+    /** Scoped-tree hosts retain their compact legacy picker alongside lazy expansion. */
+    legacyTreeLoaders?: boolean;
+};
+type SourceReferencePickerConfig = Pick<RecordFormFieldPickerConfig, 'provider' | 'reloadKey' | 'loadOptions' | 'loadTree' | 'resolveOptions'>;
+/**
+ * Retains source-authorized providers for one page-runtime instance. The source callbacks stay
+ * live so page and child-row drafts can change without recreating the picker or widening its
+ * candidate authority. SOURCE_FIELD TREE delivery is part of the same provider contract; it is
+ * never reconstructed from a paged QUERY result.
+ */
+export declare function createSourceReferencePickerConfigAssembler(): (options: SourceReferencePickerConfigOptions) => SourceReferencePickerConfig;
+export {};