@ximatai/muyun-web-app 0.26.9 → 0.26.10

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

@@ -1,11 +1,12 @@
 export type RecordDetailMode = 'create' | 'edit' | 'view';
-export interface RecordDetailCreateOptions<TRecord> {
+export type RecordDetailCancelDestination = 'close' | 'restore-view';
+export interface RecordDetailTransitionOptions {
     /**
-     * The already selected detail to reinstate if the user abandons this new
-     * draft. It is deliberately held outside `record`: while creating, the
-     * detail surface must not accidentally expose actions for the prior record.
+     * The detail surface to return to when the user cancels the operation.
+     * A row action starts an independent task and closes; an edit launched from
+     * an open detail returns to that detail view.
      */
-    restoreRecord?: TRecord;
+    cancelDestination?: RecordDetailCancelDestination;
 }
 /**
  * State transitions shared by descriptor-driven record detail surfaces.
@@ -22,12 +23,12 @@ 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>;
-    beginLoad: (next: TRecord, nextMode: Extract<RecordDetailMode, "edit" | "view">) => void;
+    beginLoad: (next: TRecord, nextMode: Extract<RecordDetailMode, "edit" | "view">, options?: RecordDetailTransitionOptions) => void;
     resolveLoad: (next: TRecord) => void;
     failLoad: () => void;
     finishLoad: () => void;
-    beginCreate: (initial: TRecord, options?: RecordDetailCreateOptions<TRecord>) => void;
-    beginEdit: () => boolean;
+    beginCreate: (initial: TRecord, options?: RecordDetailTransitionOptions) => void;
+    beginEdit: (options?: RecordDetailTransitionOptions) => boolean;
     cancelEdit: () => void;
     applySaved: (next: TRecord) => void;
     clearDeleted: () => void;

package/dist/types/platform-admin-runtime/platformModulePageEnhancement.d.ts

@@ -7,3 +7,9 @@ import type { ModulePageEnhancement } from '../dynamic-page-runtime/index';
  * Vue component or arbitrary client-side behavior.
  */
 export declare const platformModulePageEnhancement: ModulePageEnhancement;
+/**
+ * Action management has no menu identity of its own. Its standard CRUD page is
+ * entered from exactly one governed platform module, which is the hidden and
+ * immutable navigator scope.
+ */
+export declare const platformModuleActionPageEnhancement: ModulePageEnhancement;

package/dist/types/platform-components/CrudRecordListExplorer.vue.d.ts

@@ -12,6 +12,8 @@ type __VLS_Props = {
      * They are forwarded as standard query values rather than filtered in the browser.
      */
     externalQueryValues?: Record<string, unknown>;
+    navigatorHostModuleAlias?: string;
+    navigatorTargetLevelKey?: string;
     keyword?: string;
     emptyDescription?: string;
     loadingTip?: string;
@@ -43,6 +45,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     mode: CrudRecordListMode;
     filterOption: (record: CrudRecordListBase, normalizedKeyword: string) => boolean;
     emptyDescription: string;
+    navigatorHostModuleAlias: string;
+    navigatorTargetLevelKey: string;
     selectedId: string;
     keyword: string;
     titleOf: (record: CrudRecordListBase) => string;

package/dist/types/platform-components/ManagementPanelHeader.vue.d.ts

@@ -4,6 +4,7 @@ type __VLS_Props = {
     subtitle?: string;
     titleActionIcon?: UiIconName;
     titleActionTitle?: string;
+    titleActionDisabled?: boolean;
 };
 declare var __VLS_1: {}, __VLS_11: {}, __VLS_13: {};
 type __VLS_Slots = {} & {
@@ -21,6 +22,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     subtitle: string;
     titleActionIcon: UiIconName;
     titleActionTitle: string;
+    titleActionDisabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/types/platform-components/RecordDetailDrawer.vue.d.ts

@@ -3,8 +3,8 @@ import type { DrawerPromotion } from './drawerPromotion';
 type __VLS_Props = {
     open: boolean;
     title: string;
-    /** Explicit page container for a locally scoped drawer. Omitted uses the active tab host. */
-    container?: HTMLElement | null;
+    /** `inline` keeps slot anchors in the owning workspace; `portal` uses the standard side-panel host. */
+    renderMode?: 'inline' | 'portal';
     subtitle?: string;
     width?: number | string;
     scope?: UiSidePanelScope;
@@ -22,14 +22,16 @@ type __VLS_Slots = {
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     close: () => any;
+    afterClose: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClose?: (() => any) | undefined;
+    onAfterClose?: (() => any) | undefined;
 }>, {
     scope: UiSidePanelScope;
     width: number | string;
     subtitle: string;
     closeOnOutside: boolean;
-    container: HTMLElement | null;
+    renderMode: "inline" | "portal";
     closeTitle: string;
     promotion: DrawerPromotion;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/types/platform-components/RecordExplorerPanel.vue.d.ts

@@ -1,5 +1,6 @@
 type __VLS_Props = {
     title: string;
+    subtitle?: string;
     refreshTitle?: string;
     searchKeyword?: string;
     searchPlaceholder?: string;
@@ -24,6 +25,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onRefresh?: (() => any) | undefined;
     "onUpdate:searchKeyword"?: ((keyword: string) => any) | undefined;
 }>, {
+    subtitle: string;
     searchPlaceholder: string;
     refreshTitle: string;
     searchKeyword: string;

package/dist/types/platform-components/RecordFormFields.vue.d.ts

@@ -25,13 +25,13 @@ type __VLS_Props = {
 };
 declare var __VLS_1: {
     field: RecordFormFieldState;
-}, __VLS_126: {
+}, __VLS_134: {
     field: RecordFormFieldState;
 };
 type __VLS_Slots = {} & {
     'before-field'?: (props: typeof __VLS_1) => any;
 } & {
-    'after-field'?: (props: typeof __VLS_126) => any;
+    'after-field'?: (props: typeof __VLS_134) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:field": (fieldName: string, value: RecordFormFieldValue) => any;

package/dist/types/platform-components/RecordModeDrawer.vue.d.ts

@@ -47,6 +47,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     close: () => any;
     edit: () => any;
     save: () => any;
+    afterClose: () => any;
     retry: () => any;
     reloadExternalChange: () => any;
     dismissExternalChange: () => any;
@@ -54,6 +55,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onClose?: (() => any) | undefined;
     onEdit?: (() => any) | undefined;
     onSave?: (() => any) | undefined;
+    onAfterClose?: (() => any) | undefined;
     onRetry?: (() => any) | undefined;
     onReloadExternalChange?: (() => any) | undefined;
     onDismissExternalChange?: (() => any) | undefined;

package/dist/types/platform-components/RecordPanelButton.vue.d.ts

@@ -4,6 +4,7 @@ type __VLS_Props = {
     disabled?: boolean;
     loading?: boolean;
     danger?: boolean;
+    size?: 'small' | 'middle' | 'large';
     title?: string;
     ariaLabel?: string;
     iconName?: UiIconName;
@@ -20,6 +21,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     type: "default" | "primary" | "dashed" | "link" | "text";
     title: string;
     danger: boolean;
+    size: "small" | "middle" | "large";
     disabled: boolean;
     loading: boolean;
     ariaLabel: string;

package/dist/types/platform-components/RecordPicker.vue.d.ts

@@ -21,9 +21,11 @@ type __VLS_Props = {
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     select: (record: RecordPickerRecord | undefined) => any;
     "update:value": (value: string | undefined) => any;
+    "selection-resolved": (record: RecordPickerRecord | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onSelect?: ((record: RecordPickerRecord | undefined) => any) | undefined;
     "onUpdate:value"?: ((value: string | undefined) => any) | undefined;
+    "onSelection-resolved"?: ((record: RecordPickerRecord | undefined) => any) | undefined;
 }>, {
     mode: RecordPickerMode;
     disabled: boolean;

package/dist/types/platform-components/RecordQueryListPanel.vue.d.ts

@@ -1,5 +1,5 @@
 import { type Component } from 'vue';
-import type { QuerySchema, ResolvedViewFieldDescriptor } from '../web-contracts/index';
+import type { QuerySchema, ResolvedPageListPersistentQueryControlDescriptor, ResolvedViewFieldDescriptor, ResolvedPageListQuerySummaryDescriptor } from '../web-contracts/index';
 import { type ModuleContext } from '../web-core/index';
 import { type RecordActionItem, type ResolvedRecordActionItem } from './recordActionBarModel';
 export type QueryListRecord = Record<string, unknown> & {
@@ -78,6 +78,10 @@ type __VLS_Props = {
     pageable?: boolean;
     ready?: boolean;
     externalQueryValues?: Record<string, unknown>;
+    /** Descriptor-owned controls rendered after quick search and before advanced filtering. */
+    persistentQueryControls?: ResolvedPageListPersistentQueryControlDescriptor[];
+    /** Descriptor-owned result-set facts rendered at the left of the list footer. */
+    querySummaries?: ResolvedPageListQuerySummaryDescriptor[];
     /** Descriptor-owned external criteria that must be exposed by the query schema. */
     requiredExternalCriteriaKeys?: string[];
     quickSearchPlaceholder?: string;
@@ -169,6 +173,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     querySchema: QuerySchema;
     queryable: boolean;
     pageable: boolean;
+    persistentQueryControls: ResolvedPageListPersistentQueryControlDescriptor[];
+    querySummaries: ResolvedPageListQuerySummaryDescriptor[];
     requiredExternalCriteriaKeys: string[];
     quickSearchPlaceholder: string;
     waitingDescription: string;

package/dist/types/platform-components/RecordStatusSwitch.vue.d.ts

@@ -4,6 +4,7 @@ type __VLS_Props = {
     /** Explains why this otherwise visible status control is unavailable. */
     disabledReason?: string;
     loading?: boolean;
+    size?: 'default' | 'small';
     showLabel?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -12,6 +13,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     onChange?: ((enabled: boolean) => any) | undefined;
 }>, {
     enabled: boolean;
+    size: "default" | "small";
     disabled: boolean;
     loading: boolean;
     disabledReason: string;

package/dist/types/platform-components/TreeRecordExplorer.vue.d.ts

@@ -9,6 +9,8 @@ type __VLS_Props = {
     reloadKey?: number;
     /** Descriptor-owned criteria from upstream navigator levels. */
     externalQueryValues?: Record<string, unknown>;
+    navigatorHostModuleAlias?: string;
+    navigatorTargetLevelKey?: string;
     keyword?: string;
     searchMode?: TreeRecordSearchMode;
     searchTrigger?: 'inline' | 'external';
@@ -42,6 +44,8 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
 }>, {
     filterOption: (record: TreeRecordBase, normalizedKeyword: string) => boolean;
     emptyDescription: string;
+    navigatorHostModuleAlias: string;
+    navigatorTargetLevelKey: string;
     searchPlaceholder: string;
     selectedId: string;
     keyword: string;

package/dist/types/platform-components/index.d.ts

@@ -82,7 +82,6 @@ export type { PlatformDateTimeDisplay, PlatformDateTimeOptions, PlatformDateTime
 export { applyReferenceDependencyClears, childResourceDefaultFormViewCode, resolveRecordDetailFields, resolveRecordFormFieldNames, resolveRecordBooleanStatusValue, resolveRecordFormFieldState, resolveRecordFormFields, evaluateUiFormula, recordFieldRendererRegistry, } from './recordFormFieldModel';
 export { createQueryScopedTreeModuleContext, createScopedTreeClient, createScopedTreeModuleContext, } from './scopedTreeModuleContext';
 export { createEmptyStaticTreeClient, createStaticTreeResourceModuleContext, } from './staticTreeResourceModuleContext';
-export { createScopedResourceTreeModuleContext } from './scopedResourceTreeModuleContext';
 export { presentPlatformError, presentPlatformMessage, presentPlatformSuccess, } from './platformErrorFeedback';
 export { handlePlatformActionSuccess, presentPlatformActionSuccess } from './platformActionResultFeedback';
 export { createPlatformActionResultReactionHandlers, mergePlatformActionResultReactionHandlers, platformActionResultReactions, platformActionResultReactionTypes, resolvePlatformActionResult, resolvePlatformActionResultMessage, withPlatformActionResultReactions, } from './platformActionResultReactions';
@@ -98,4 +97,3 @@ export type { StaticCrudCardMode, StaticCrudConfirmAction, StaticCrudManagementO
 export type { TreeRecordBase } from './treeRecordModel';
 export type { ScopedTreeModuleContextOptions } from './scopedTreeModuleContext';
 export type { StaticTreeResourceModuleContextOptions } from './staticTreeResourceModuleContext';
-export type { ScopedResourceTreeModuleContextOptions } from './scopedResourceTreeModuleContext';

package/dist/types/platform-components/recordFormFieldModel.d.ts

@@ -14,6 +14,11 @@ export type RecordFormFieldDescriptor = (ViewFieldDefinition | ResolvedViewField
     valueType?: ViewFieldValueType;
 };
 export type RecordFormRecord = Record<string, unknown>;
+/**
+ * Ephemeral, descriptor-authorized values from selected ONE references. These are deliberately
+ * separate from the draft because they describe the selected target, not fields owned by it.
+ */
+export type RecordFormSelectionContext = Record<string, unknown>;
 /**
  * Applies the platform-owned consequence of changing a reference dependency.
  * The owner of a draft record calls this after accepting a field edit, so the
@@ -94,6 +99,8 @@ export interface RecordFormFieldState {
     pickerConfig?: RecordFormFieldPickerConfig;
     booleanStatus?: BooleanStatusPresentation;
     valuePresentation?: FieldValuePresentation;
+    /** Source field used while this nullable field is inheriting instead of overriding. */
+    overrideOf?: string;
     disabledHint?: string;
     placeholder?: string;
     options?: Option[];
@@ -111,7 +118,7 @@ export declare function resolveRecordFormFields(uiDescriptor: ResolvedModuleUiDe
  * navigator-provided scope), while avoiding editor-only controls in the standard detail grid.
  * Pages without an explicit display retain the existing editor-as-display fallback.
  */
-export declare function resolveRecordDetailFields(uiDescriptor: ResolvedModuleUiDescriptor | undefined): Map<string, RecordFormFieldDescriptor>;
+export declare function resolveRecordDetailFields(uiDescriptor: ResolvedModuleUiDescriptor | undefined, resource?: string): Map<string, RecordFormFieldDescriptor>;
 export declare function resolveRecordFormGroups(uiDescriptor: ResolvedModuleUiDescriptor | undefined, resource?: string, editorSurface?: string): FormGroupDescriptor[];
 export declare function childResourceDefaultFormViewCode(resource: string): string;
 export declare function resolveRecordFormFieldState(fieldName: string, options?: {
@@ -120,8 +127,15 @@ export declare function resolveRecordFormFieldState(fieldName: string, options?:
     pickerConfigs?: Record<string, RecordFormFieldPickerConfig>;
     placeholderOf?: (fieldName: string, field: RecordFormFieldState) => string | undefined;
     record?: RecordFormRecord;
+    selectionContext?: RecordFormSelectionContext;
 }): RecordFormFieldState;
-export declare function evaluateUiFormula(formula: UiFormula, record: RecordFormRecord): boolean;
+export declare function evaluateUiFormula(formula: UiFormula, record: RecordFormRecord, selectionContext?: RecordFormSelectionContext): boolean;
+/**
+ * Produces the only reference-derived values that WEB_UI formulas may observe. The descriptor
+ * owns both the source field and relative target paths; browser code never infers a path from a
+ * candidate object. The first delivery supports ONE references only.
+ */
+export declare function resolveReferenceSelectionContext(sourceField: string, reference: ResolvedReferenceFieldDescriptor | undefined, record: RecordPickerRecord | undefined): RecordFormSelectionContext;
 /**
  * Preserves an absent business value as unknown instead of treating it as true.
  * `enabledStatus` deliberately retains its separate lifecycle default semantics.

package/dist/types/platform-components/recordPickerConstraints.d.ts

@@ -6,6 +6,8 @@ export interface RecordPickerRecord {
     enabled?: boolean;
     /** Server-authorized values applied after choosing this candidate. */
     affectPatch?: Record<string, unknown>;
+    /** Server-authorized target projections used only by the owning form's transient UI context. */
+    projections?: Record<string, unknown>;
 }
 export interface PickerConstraintContext<TRecord extends RecordPickerRecord> {
     records: TRecord[];

package/dist/types/platform-workbench/Workbench.vue.d.ts

@@ -9,13 +9,13 @@ type __VLS_Props = {
     realtimeStatus?: WorkbenchRealtimeStatus;
     themeAppearance?: 'light' | 'dark';
 };
-declare var __VLS_80: {
+declare var __VLS_82: {
     activeTab: MenuTab;
     target: MenuNavigationTarget | undefined;
     pageDescriptor: PageDescriptor | undefined;
 };
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_80) => any;
+    default?: (props: typeof __VLS_82) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     closeTabs: (keys: string[]) => any;
@@ -25,6 +25,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     closeTab: (key: string) => any;
     toggleTabLock: (key: string) => any;
     reorderTabs: (keys: string[]) => any;
+    refreshPage: (key: string) => any;
     "update:activeTabKey": (key: string) => any;
     userCommand: (key: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
@@ -35,6 +36,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onCloseTab?: ((key: string) => any) | undefined;
     onToggleTabLock?: ((key: string) => any) | undefined;
     onReorderTabs?: ((keys: string[]) => any) | undefined;
+    onRefreshPage?: ((key: string) => any) | undefined;
     "onUpdate:activeTabKey"?: ((key: string) => any) | undefined;
     onUserCommand?: ((key: string) => any) | undefined;
 }>, {

package/dist/types/vue-ui-antdv/components/UiSidePanel.vue.d.ts

@@ -5,14 +5,16 @@ type __VLS_Props = {
     closeOnOutside?: boolean;
     scope?: UiSidePanelScope;
 };
-declare var __VLS_10: {};
+declare var __VLS_11: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_10) => any;
+    default?: (props: typeof __VLS_11) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     close: () => any;
+    afterClose: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClose?: (() => any) | undefined;
+    onAfterClose?: (() => any) | undefined;
 }>, {
     scope: UiSidePanelScope;
     width: number | string;

package/dist/types/vue-ui-antdv/components/UiSwitch.vue.d.ts

@@ -2,6 +2,7 @@ type __VLS_Props = {
     checked?: boolean;
     disabled?: boolean;
     loading?: boolean;
+    size?: 'default' | 'small';
     checkedText?: string;
     uncheckedText?: string;
 };
@@ -12,6 +13,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     "onUpdate:checked"?: ((checked: boolean) => any) | undefined;
     onChange?: ((checked: boolean) => any) | undefined;
 }>, {
+    size: "default" | "small";
     disabled: boolean;
     loading: boolean;
     checked: boolean;

package/dist/types/web-contracts/index.d.ts

@@ -19,6 +19,12 @@ export interface WebPageResponse<T> {
     pages: number;
     totalKnown: boolean;
     navigation?: unknown;
+    summaries?: WebListQuerySummaryItem[];
+}
+/** Value of one footer summary for the complete result set of the current list query. */
+export interface WebListQuerySummaryItem {
+    key: string;
+    value: unknown;
 }
 export declare const webDataChangeTypes: {
     readonly recordCreated: "record-created";
@@ -409,7 +415,7 @@ export type MenuScopeType = 'system' | 'tenant' | 'organization';
 export interface MenuScheme extends StandardEnabledSortableEntity {
     alias?: string;
     scopeType?: MenuScopeType;
-    scopeId?: string;
+    organizationId?: string;
 }
 export interface ModuleMenuTarget {
     menuId: string;
@@ -550,6 +556,9 @@ export interface WebQueryRequest {
     quickSearch?: string;
     quickSearchFields?: string[];
     externalQueryValues?: Record<string, unknown>;
+    /** Host page and target level for a navigator REFERENCE query. */
+    navigatorHostModuleAlias?: string;
+    navigatorTargetLevelKey?: string;
 }
 /** Shared field-reference delivery contract for static and metadata-backed modules. */
 export type WebReferenceResolveMode = 'QUERY' | 'TREE' | 'TRANSLATE';
@@ -574,6 +583,14 @@ export interface WebReferenceResolveRequest {
     uiConfigId?: string;
     queryTemplateId?: string;
     externalQueryValues?: Record<string, unknown>;
+    /**
+     * Host page that owns this navigator reference request.  Reference transports
+     * use it only to resolve the declared NAVIGATOR_QUERY bindings; ordinary
+     * module queries deliberately ignore it.
+     */
+    navigatorHostModuleAlias?: string;
+    /** Navigator level in the host page whose source is being queried. */
+    navigatorTargetLevelKey?: string;
 }
 export interface WebReferenceResolveItem {
     id: string;
@@ -682,6 +699,8 @@ export interface ViewFieldDefinition {
     maxDisplayLines?: number;
     /** User-facing title for the standard tree root sentinel in a detail field. */
     treeRootTitle?: string;
+    /** Nullable field inherits this source field until an explicit override is selected. */
+    overrideOf?: string;
 }
 /** Semantic group that owns a contiguous set of standard-form fields. */
 export interface FormGroupDescriptor {
@@ -731,6 +750,8 @@ export interface ResolvedViewFieldDescriptor {
     fixed?: boolean;
     booleanStatus?: BooleanStatusPresentation;
     treeRootTitle?: string;
+    /** Nullable field inherits this source field until an explicit override is selected. */
+    overrideOf?: string;
     option?: ResolvedOptionFieldDescriptor;
     reference?: ResolvedReferenceFieldDescriptor;
     referenceSummary?: ResolvedReferenceSummaryFieldDescriptor;
@@ -756,6 +777,19 @@ export interface ResolvedReferenceFieldDescriptor {
     candidateDependencies?: ReferenceCandidateDependency[];
     /** Read-side title projection for this scalar reference, when supplied by the server. */
     titleField?: string;
+    /**
+     * Explicitly authorized target-field paths available after choosing this ONE reference.
+     * Paths are relative to this reference field; the form runtime prefixes them with the
+     * descriptor-owned source field name before exposing them to WEB_UI formulas.
+     */
+    selectionProjections?: ResolvedReferenceSelectionProjectionDescriptor[];
+}
+/**
+ * A declared projection below a record-picker target. Every non-terminal segment is a declared
+ * ONE reference; the terminal segment is the selected value delivered by the server.
+ */
+export interface ResolvedReferenceSelectionProjectionDescriptor {
+    path: string[];
 }
 export interface ReferenceCandidateDependency {
     sourceField: string;
@@ -813,11 +847,12 @@ export type ModulePageTemplate = 'FLAT_MANAGEMENT' | 'LIST_DETAIL_CARD' | 'TREE_
 export interface ResolvedPageExplorerDescriptor {
     title: string;
     searchPlaceholder: string;
+    /** Optional record field rendered as the compact navigator secondary identity. */
+    secondaryField?: string;
     emptyDescription: string;
     recordLabel: string;
     fallbackTitle: string;
     titleField: string;
-    secondaryField?: string;
     mutedWhenDisabled: boolean;
 }
 export interface ResolvedPageNavigatorDescriptor {
@@ -830,6 +865,8 @@ export interface ResolvedPageNavigatorLevelDescriptor {
     sourceModuleAlias: string;
     title: string;
     searchPlaceholder: string;
+    /** Optional record field rendered as the compact navigator secondary identity. */
+    secondaryField?: string;
     /** Presentation policy applied after the source has authoritatively loaded. */
     singleResultPolicy?: 'NONE' | 'AUTO_SELECT' | 'AUTO_SELECT_AND_HIDE';
     /** Explicit initial selection policy; omitted means the navigator starts unselected. */
@@ -850,6 +887,11 @@ export interface ResolvedPageContextBindingDescriptor {
     targetNavigatorLevelKey?: string;
     /** Field name of the record picker which receives this query context. */
     targetPickerFieldKey?: string;
+    /**
+     * Only applies to NAVIGATOR -> LIST_QUERY. Omitted descriptors remain required for backwards
+     * compatibility with previously published page definitions.
+     */
+    navigatorListQueryMode?: 'REQUIRED_SCOPE' | 'OPTIONAL_FILTER';
 }
 export interface ResolvedPageNavigatorManagementDescriptor {
     /** Optional named source-module form; the default editor is used when omitted. */
@@ -860,6 +902,21 @@ export interface ResolvedPageListDescriptor {
     fields: ResolvedViewDescriptor;
     /** Read-only placements of declared aggregate relations beneath an expanded list row. */
     relationExpansions?: ResolvedPageListRelationExpansionDescriptor[];
+    persistentQueryControls?: ResolvedPageListPersistentQueryControlDescriptor[];
+    querySummaries?: ResolvedPageListQuerySummaryDescriptor[];
+}
+export interface ResolvedPageListQuerySummaryDescriptor {
+    key: string;
+    title: string;
+    source: 'MATCHED_COUNT' | 'CONTRIBUTOR';
+    contributorKey?: string;
+}
+/** A persistent boolean query control rendered after search and before advanced filtering. */
+export interface ResolvedPageListPersistentQueryControlDescriptor {
+    externalCriteriaKey: string;
+    title: string;
+    uiType: 'SWITCH';
+    defaultValue: boolean;
 }
 export interface ResolvedPageListRelationExpansionDescriptor {
     relationCode: string;
@@ -884,9 +941,22 @@ export interface ResolvedModulePageDescriptor {
     explorer?: ResolvedPageExplorerDescriptor;
     navigator?: ResolvedPageNavigatorDescriptor;
     list?: ResolvedPageListDescriptor;
+    /** Declared action-contribution tree rendered as the main TREE_MANAGEMENT resource. */
+    treeResource?: ResolvedPageTreeResourceDescriptor;
     detail: ResolvedPageDetailDescriptor;
     traits: ('STANDARD_CRUD' | 'ENABLED_STATUS' | 'RECYCLE_BIN' | 'RESPONSIVE_DETAIL_SURFACE')[];
 }
+export interface ResolvedPageTreeResourceDescriptor {
+    resource: string;
+    scopeNavigatorKey: string;
+    scopeField: string;
+    /** Optional exact-value condition on the selected navigator record. */
+    scopeRecordField?: string;
+    scopeRecordEquals?: string;
+    title: string;
+    emptyDescription: string;
+    createTitle: string;
+}
 export interface ResolvedUiActionConfirmationDescriptor {
     mode: 'typedText';
     requiredField: string;

package/dist/types/web-core/http.d.ts

@@ -18,6 +18,12 @@ export interface HttpRequestOptions {
 export interface HttpClient {
     request<T>(options: HttpRequestOptions): Promise<T>;
 }
+/**
+ * Narrows an existing client to one trusted request context without teaching
+ * module clients about a particular page, menu, or business domain.
+ */
+export declare function withHttpHeaders(client: StreamingHttpClient, headers: Record<string, string | undefined> | (() => Record<string, string | undefined>), appliesTo?: (request: HttpRequestOptions) => boolean): StreamingHttpClient;
+export declare function withHttpHeaders(client: HttpClient, headers: Record<string, string | undefined> | (() => Record<string, string | undefined>), appliesTo?: (request: HttpRequestOptions) => boolean): HttpClient;
 /**
  * Optional capability implemented by HTTP clients that can open a response body
  * as a stream. Keeping it separate preserves compatibility with application

package/dist/types/web-core/module/index.d.ts

@@ -1,6 +1,6 @@
 export * from './abilityCodes';
 export * from './recycleBin';
 export * from './staticModuleClient';
-export type { ModuleActionState, ModuleRuntimeAction, ModuleRuntimeContext, ModuleRuntimeContextState, } from './runtimeContext';
+export type { ModuleActionState, ModuleRecordActionAvailability, ModuleRuntimeAction, ModuleRuntimeContext, ModuleRuntimeContextState, } from './runtimeContext';
 export type { ModuleAbilityClients, ModuleAbilities } from './abilities';
 export * from './moduleContext';

package/dist/types/web-core/module/moduleContext.d.ts

@@ -1,7 +1,7 @@
 import type { HttpClient } from '../http';
 import { type ModuleAbilities } from './abilities';
 import { type ModuleActionState, type ModuleRecordActionAvailability, type ModuleRuntimeAction, type ModuleRuntimeContextState } from './runtimeContext';
-import { type ModuleCrudClient, type ModuleTreeClient } from './staticModuleClient';
+import { type NavigatorReferenceRequestContext, type ModuleCrudClient, type ModuleTreeClient } from './staticModuleClient';
 export interface ModuleContext<TRecord> {
     moduleAlias: string;
     http: HttpClient;
@@ -26,6 +26,7 @@ export interface ModuleContextConfig {
 export interface ModuleContextOptions extends ModuleContextConfig {
     moduleAlias: string;
     runtimeAccess?: 'MENU' | 'REFERENCE';
+    navigatorReference?: NavigatorReferenceRequestContext;
 }
 export declare function configureModuleContext(config: ModuleContextConfig): void;
 export declare function provideModuleContextConfig(config: ModuleContextConfig): void;

package/dist/types/web-core/module/staticModuleClient.d.ts

@@ -60,6 +60,7 @@ export declare function createModuleCrudClient<TRecord>(http: HttpClient, option
 /** The navigation-only read surface deliberately does not reuse the module query endpoint. */
 export declare function createNavigatorReferenceCrudClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
+    navigatorReference?: NavigatorReferenceRequestContext;
 }): ModuleCrudClient<TRecord>;
 export declare function createStaticResourceCrudClient<TRecord>(http: HttpClient, resourcePath: string): ModuleCrudClient<TRecord>;
 export declare function createModuleTreeClient<TRecord>(http: HttpClient, options: {
@@ -67,7 +68,12 @@ export declare function createModuleTreeClient<TRecord>(http: HttpClient, option
 }): ModuleTreeClient<TRecord>;
 export declare function createNavigatorReferenceTreeClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
+    navigatorReference?: NavigatorReferenceRequestContext;
 }): ModuleTreeClient<TRecord>;
+export interface NavigatorReferenceRequestContext {
+    hostModuleAlias: string;
+    targetLevelKey: string;
+}
 export declare function createStaticResourceTreeClient<TRecord>(http: HttpClient, resourcePath: string): ModuleTreeClient<TRecord>;
 /** @deprecated Use ModuleCrudClient. Remove after static-prefixed consumer imports migrate. */
 export type StaticModuleCrudClient<TRecord> = ModuleCrudClient<TRecord>;

package/dist/types/web-core/realtime.d.ts

@@ -23,8 +23,16 @@ export interface RealtimeClient {
     state(): RealtimeConnectionState;
 }
 export interface RealtimeClientOptions {
+    /**
+     * Backend API base URL. The default WebSocket endpoint is resolved relative
+     * to this path, so an API mounted at `/api` connects to `/api/ws/platform`.
+     */
     baseUrl?: string;
     token?: string;
+    /**
+     * WebSocket endpoint relative to {@link baseUrl}. A root-relative or
+     * absolute URL remains an explicit override for deployments that need it.
+     */
     brokerPath?: string;
     reconnectDelay?: number;
     heartbeatIncoming?: number;