@ximatai/muyun-web-app 0.26.7 → 0.26.8

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

@@ -1,6 +1,8 @@
 type __VLS_Props = {
     enabled?: boolean;
     disabled?: boolean;
+    /** Explains why this otherwise visible status control is unavailable. */
+    disabledReason?: string;
     loading?: boolean;
     showLabel?: boolean;
 };
@@ -12,6 +14,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     enabled: boolean;
     disabled: boolean;
     loading: boolean;
+    disabledReason: string;
     showLabel: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

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

@@ -7,20 +7,25 @@ type __VLS_Props = {
     explorerSearchKeyword?: string;
     explorerSearchPlaceholder?: string;
     explorerSearchable?: boolean;
+    navigatorCount?: number;
 };
-declare var __VLS_24: {}, __VLS_26: {}, __VLS_29: {}, __VLS_38: {}, __VLS_41: {}, __VLS_43: {};
+declare var __VLS_14: {
+    index: number;
+}, __VLS_32: {}, __VLS_34: {}, __VLS_37: {}, __VLS_46: {}, __VLS_49: {}, __VLS_51: {};
 type __VLS_Slots = {} & {
-    'explorer-actions'?: (props: typeof __VLS_24) => any;
+    navigator?: (props: typeof __VLS_14) => any;
 } & {
-    explorer?: (props: typeof __VLS_26) => any;
+    'explorer-actions'?: (props: typeof __VLS_32) => any;
 } & {
-    'explorer-footer'?: (props: typeof __VLS_29) => any;
+    explorer?: (props: typeof __VLS_34) => any;
 } & {
-    'detail-status'?: (props: typeof __VLS_38) => any;
+    'explorer-footer'?: (props: typeof __VLS_37) => any;
 } & {
-    'detail-actions'?: (props: typeof __VLS_41) => any;
+    'detail-status'?: (props: typeof __VLS_46) => any;
 } & {
-    default?: (props: typeof __VLS_43) => any;
+    'detail-actions'?: (props: typeof __VLS_49) => any;
+} & {
+    default?: (props: typeof __VLS_51) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     refresh: () => any;
@@ -33,6 +38,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     explorerSearchKeyword: string;
     explorerSearchPlaceholder: string;
     explorerSearchable: boolean;
+    navigatorCount: number;
 }, {}, {}, {}, 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/TreeRecordExplorer.vue.d.ts

@@ -7,6 +7,8 @@ type __VLS_Props = {
     context: ModuleContext<TreeRecordBase>;
     selectedId?: string;
     reloadKey?: number;
+    /** Descriptor-owned criteria from upstream navigator levels. */
+    externalQueryValues?: Record<string, unknown>;
     keyword?: string;
     searchMode?: TreeRecordSearchMode;
     searchTrigger?: 'inline' | 'external';
@@ -47,6 +49,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
     tagOf: (record: TreeRecordBase) => string | undefined;
     mutedOf: (record: TreeRecordBase) => boolean;
     reloadKey: number;
+    externalQueryValues: Record<string, unknown>;
     loadingTip: string;
     fallbackTitle: string;
     searchMode: TreeRecordSearchMode;

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

@@ -1,5 +1,6 @@
 export {};
 export { default as ApplicationScopeSwitcher } from './ApplicationScopeSwitcher.vue';
+export { default as BusinessNotificationPanel } from './BusinessNotificationPanel.vue';
 export { confirmAction } from '../vue-ui-antdv/index';
 export { default as CrudRecordListExplorer } from './CrudRecordListExplorer.vue';
 export { default as DrawerOperationBar } from './DrawerOperationBar.vue';
@@ -13,6 +14,7 @@ export { default as EnabledSelect } from './EnabledSelect.vue';
 export { default as ModuleActionButton } from './ModuleActionButton.vue';
 export { default as ManagementWorkspace } from './ManagementWorkspace.vue';
 export { default as ManagementExplorerColumn } from './ManagementExplorerColumn.vue';
+export { MANAGEMENT_WORKSPACE_LAYOUT, listDetailWorkspaceMinWidth } from './managementWorkspaceLayout';
 export { providePageLayout, usePageLayout } from './pageLayoutContext';
 export { default as RecordActionBar } from './RecordActionBar.vue';
 export { default as RecordDetailDrawer } from './RecordDetailDrawer.vue';
@@ -56,7 +58,7 @@ export type { RecordPickerMode } from './recordPickerModel';
 export type { RecordActionItem, ResolvedRecordActionItem } from './recordActionBarModel';
 export type { RecordDetailDisplayResolver, RecordDetailDisplayValue } from './recordDetailFieldModel';
 export type { RecordListExplorerRecord } from './RecordListExplorer.vue';
-export type { QueryListRecord, RecordQueryListCellComponent, RecordQueryListColumn, RecordQueryListMode, } from './RecordQueryListPanel.vue';
+export type { QueryListRecord, RecordQueryListCellComponent, RecordQueryListColumn, RecordQueryListMode, StandardCrudRowActionKey, } from './RecordQueryListPanel.vue';
 export type { RecordFormFieldDescriptor, RecordFormFieldFallback, RecordFormFieldPickerConfig, RecordFormFieldState, RecordFormFieldValue, RecordFormRecord, } from './recordFormFieldModel';
 export type { CrudRecordListBase } from './crudRecordListModel';
 export { defaultCrudRecordListMatches, defaultCrudRecordListSubtitle, defaultCrudRecordListTitle, } from './crudRecordListModel';
@@ -70,7 +72,7 @@ export type { PlatformFileSizeDisplay, PlatformFileSizeOptions } from './platfor
 export { providePlatformTimeZoneContext, usePlatformTimeZoneContext } from './platformTimeZoneContext';
 export type { PlatformDateTimeDisplay, PlatformDateTimeOptions, PlatformDateTimePrecision, } from './platformDateTime';
 export { childResourceDefaultFormViewCode, resolveRecordFormFieldNames, resolveRecordFormFieldState, resolveRecordFormFields, } from './recordFormFieldModel';
-export { createScopedTreeClient, createScopedTreeModuleContext } from './scopedTreeModuleContext';
+export { createQueryScopedTreeModuleContext, createScopedTreeClient, createScopedTreeModuleContext, } from './scopedTreeModuleContext';
 export { createEmptyStaticTreeClient, createStaticTreeResourceModuleContext, } from './staticTreeResourceModuleContext';
 export { createScopedResourceTreeModuleContext } from './scopedResourceTreeModuleContext';
 export { presentPlatformError, presentPlatformMessage, presentPlatformSuccess, } from './platformErrorFeedback';

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

@@ -0,0 +1,14 @@
+/**
+ * Shared geometry for the platform management workspace.
+ *
+ * Keep responsive promotion independent from each page's DSL: descriptors say
+ * whether a page has a detail surface; the runtime decides whether that surface
+ * can share the available workspace with its list and navigators.
+ */
+export declare const MANAGEMENT_WORKSPACE_LAYOUT: {
+    readonly explorerWidth: 280;
+    readonly listMinWidth: 720;
+    readonly detailMinWidth: 560;
+    readonly columnGap: 12;
+};
+export declare function listDetailWorkspaceMinWidth(explorerCount: number): number;

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

@@ -60,8 +60,8 @@ export interface ResolveRecordFormFieldNamesOptions {
     exclude?: Iterable<string>;
 }
 export declare function resolveRecordFormFieldNames(fields?: Map<string, RecordFormFieldDescriptor>, fallback?: Record<string, RecordFormFieldFallback>, options?: ResolveRecordFormFieldNamesOptions): string[];
-export declare function resolveRecordFormFields(uiDescriptor: ResolvedModuleUiDescriptor | undefined, viewCode?: string): Map<string, RecordFormFieldDescriptor>;
-export declare function resolveRecordFormGroups(uiDescriptor: ResolvedModuleUiDescriptor | undefined, viewCode?: string): FormGroupDescriptor[];
+export declare function resolveRecordFormFields(uiDescriptor: ResolvedModuleUiDescriptor | undefined, resource?: string, editorSurface?: 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?: {
     fields?: Map<string, RecordFormFieldDescriptor>;

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

@@ -7,6 +7,8 @@ export interface RecycleBinStateOptions<TRecord> {
     /** 外部刷新信号，变化时重新加载列表 */
     reloadKey?: Ref<number>;
 }
+/** Turns lifecycle facts from the platform into concise operator-facing guidance. */
+export declare function recycleBinRestoreUnavailableReason(item: RecycleBinItem<unknown>): string | undefined;
 export declare function useRecycleBinState<TRecord>(options: RecycleBinStateOptions<TRecord>): {
     items: Ref<{
         record: import("vue").UnwrapRef<TRecord>;

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

@@ -1,3 +1,4 @@
+import type { RouteQueryValue } from '../web-contracts/index';
 import type { ModuleContext, StaticModuleTreeClient } from '../web-core/index';
 export interface ScopedTreeModuleContextOptions {
     scopeFieldName: string;
@@ -6,5 +7,15 @@ export interface ScopedTreeModuleContextOptions {
     sortPath?: string;
     treeQueryParam?: string;
 }
+/**
+ * Gives a tree client declared page-context criteria. An empty context is deliberately fail-closed:
+ * a dependent picker must not expose records from an unselected business scope.
+ */
+export interface QueryScopedTreeModuleContextOptions {
+    queryValues: Record<string, RouteQueryValue> | undefined | (() => Record<string, RouteQueryValue> | undefined);
+    treePath: string;
+    sortPath?: string;
+}
+export declare function createQueryScopedTreeModuleContext<TRecord>(context: ModuleContext<TRecord>, options: QueryScopedTreeModuleContextOptions): ModuleContext<TRecord>;
 export declare function createScopedTreeModuleContext<TRecord>(context: ModuleContext<TRecord>, options: ScopedTreeModuleContextOptions): ModuleContext<TRecord>;
 export declare function createScopedTreeClient<TRecord>(context: ModuleContext<TRecord>, options: ScopedTreeModuleContextOptions): StaticModuleTreeClient<TRecord>;

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

@@ -2,6 +2,7 @@ export { default as Workbench } from './Workbench.vue';
 export { default as WorkbenchMenu } from './WorkbenchMenu.vue';
 export { default as WorkbenchOutlet } from './WorkbenchOutlet.vue';
 export { default as WorkspaceViewOutlet } from './WorkspaceViewOutlet.vue';
+export { syncModulePageWorkspaceViewContributions } from './modulePageWorkspaceViews';
 export { provideWorkbenchNavigation, useWorkbenchNavigation } from './workbenchNavigation';
 export type { WorkbenchNavigation, WorkbenchPageOpenResult } from './workbenchNavigation';
 export { configureWorkspaceViewContributions, createWorkspaceViewDescriptor, createWorkspaceViewRegistry, dismissWorkspaceViewDescriptor, resolveWorkspaceView, } from './workspaceViews';

package/dist/types/platform-workbench/menuNavigation.d.ts

@@ -5,6 +5,8 @@ export interface PageDescriptorResolveOptions {
     businessRoutePrefixes?: string[];
     /** Optional legacy mapping for framework-owned static business pages. */
     businessModuleRoutes?: Record<string, string>;
+    /** Stable readable routes whose content is rendered by the standard dynamic module host. */
+    dynamicModuleRoutes?: Record<string, string>;
     /** Page layout contracts keyed by a static business route. */
     businessRouteLayouts?: Record<string, PageLayoutMode>;
     businessRouteNames?: string[];
@@ -15,6 +17,7 @@ export interface PageDescriptorUrlParseOptions {
     platformRoutePrefixes?: string[];
     businessRoutePrefixes?: string[];
     businessRouteLayouts?: Record<string, PageLayoutMode>;
+    dynamicModuleRoutes?: Record<string, string>;
 }
 export declare function getMenuNavigationTarget(menu: MenuRecord): MenuNavigationTarget | undefined;
 export declare function isTabMenuTarget(target: MenuNavigationTarget): boolean;

package/dist/types/platform-workbench/modulePageWorkspaceViews.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Publishes application-contributed module workspace views before URL or
+ * preference restoration resolves a workbench tab.  The module enhancement
+ * registry is the source of truth; this only adapts it to the Workbench view
+ * registry.
+ */
+export declare function syncModulePageWorkspaceViewContributions(): void;

package/dist/types/platform-workbench/workbenchLayout.d.ts

@@ -1,4 +1,40 @@
 export declare function compactMenuTopOf(topbarBottom: number, workbenchTop: number): number;
 export declare function floatingPanelTopOf(anchorViewportTop: number, panelHeight: number, viewportHeight: number, shellViewportTop: number, margin?: number): number;
+interface FloatingMenuPanelRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+interface FloatingMenuPanelAnchor {
+    left: number;
+    top: number;
+    height: number;
+}
+interface CompactMenuPanelBounds {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+interface CompactMenuAnchorBounds {
+    left: number;
+    top: number;
+    right: number;
+}
+interface CompactMenuFlyoutBounds {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+/**
+ * Builds one continuous outline for a side-menu trigger and its adjoining flyout.
+ * The flyout must begin at the trigger's right edge and never below its top edge.
+ */
+export declare function floatingMenuPanelOutlinePath(panel: FloatingMenuPanelRect, anchor: FloatingMenuPanelAnchor, anchorRadius?: number, panelRadius?: number): string;
+/** Builds the shared outline of the compact-menu trigger and its dropdown panel. */
+export declare function compactMenuPanelOutlinePath(panel: CompactMenuPanelBounds, anchor: CompactMenuAnchorBounds, anchorRadius?: number, panelRadius?: number, flyout?: CompactMenuFlyoutBounds): string;
 export type WorkbenchMenuPresentation = 'compact' | 'expanded';
 export declare function effectiveWorkbenchMenuPresentation(preferredPresentation: WorkbenchMenuPresentation, narrowViewport: boolean): WorkbenchMenuPresentation;
+export {};

package/dist/types/platform-workbench/workbenchNavigation.d.ts

@@ -4,6 +4,8 @@ export interface WorkbenchNavigation {
     openPage(descriptor: PageDescriptor): WorkbenchPageOpenResult;
     /** Replaces one existing host by its stable tab key without changing that tab's identity. */
     replacePage(pageKey: string, descriptor: PageDescriptor): void;
+    /** Closes one workbench page through the owning shell's tab-state policy. */
+    closePage(pageKey: string): void;
 }
 export interface WorkbenchPageOpenResult {
     created: boolean;

package/dist/types/platform-workbench/workspaceViewHost.d.ts

@@ -3,6 +3,8 @@ export interface WorkspaceViewHost {
     presentation: WorkspaceViewPresentation;
     setTitle(title: string): void;
     dismiss(): void;
+    /** Closes the current independent workbench view. */
+    close(): void;
 }
 export declare function provideWorkspaceViewHost(host: WorkspaceViewHost): void;
 export declare function useWorkspaceViewHost(): WorkspaceViewHost | undefined;

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

@@ -23,10 +23,10 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     type: "default" | "primary" | "dashed" | "link" | "text";
     title: string;
     danger: boolean;
+    size: "small" | "middle" | "large";
     htmlType: "button" | "submit" | "reset";
     disabled: boolean;
     loading: boolean;
-    size: "small" | "middle" | "large";
     ariaLabel: string;
     iconName: UiIconName;
     iconPosition: "start" | "end";

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

@@ -45,8 +45,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onRowDblclick?: ((record: UiDataTableRecord, event: MouseEvent) => any) | undefined;
     onRowExpand?: ((record: UiDataTableRecord, expanded: boolean) => any) | undefined;
 }>, {
-    loading: boolean;
     size: "small" | "middle" | "large";
+    loading: boolean;
     pagination: false | UiDataTablePagination;
     rowKey: string | ((record: UiDataTableRecord) => string);
     selection: UiDataTableSelection;

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

@@ -1,4 +1,4 @@
-export type UiIconName = 'app' | 'check' | 'close' | 'delete' | 'down' | 'edit' | 'export' | 'filter' | 'help' | 'left' | 'lock' | 'menu-collapse' | 'menu-expand' | 'notification' | 'plus' | 'pin' | 'power' | 'reload' | 'right' | 'save' | 'search' | 'skin' | 'settings';
+export type UiIconName = 'app' | 'check' | 'close' | 'delete' | 'down' | 'edit' | 'export' | 'filter' | 'help' | 'left' | 'lock' | 'menu-collapse' | 'menu-expand' | 'notification' | 'open-in-new' | 'plus' | 'pin-off' | 'pin' | 'power' | 'reload' | 'right' | 'save' | 'search' | 'skin' | 'settings';
 type __VLS_Props = {
     name: UiIconName;
 };

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

@@ -19,8 +19,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onCancel?: (() => any) | undefined;
     onConfirm?: (() => any) | undefined;
 }>, {
-    closable: boolean;
     width: number | string;
+    closable: boolean;
     confirmText: string;
     cancelText: string;
     confirmLoading: boolean;

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

@@ -17,12 +17,12 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     onSearch?: ((keyword: string) => any) | undefined;
     "onUpdate:value"?: ((value: OptionValue | OptionValueList | null) => any) | undefined;
 }>, {
+    mode: "multiple";
     disabled: boolean;
     loading: boolean;
     value: OptionValue | OptionValueList | null;
     placeholder: string;
     allowClear: boolean;
-    mode: "multiple";
     showSearch: boolean;
     filterOption: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -12,19 +12,25 @@ type __VLS_Props = {
     placeholder?: string;
     disabled?: boolean;
     allowClear?: boolean;
+    showSearch?: boolean;
+    filterTreeNode?: boolean;
     loading?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    search: (keyword: string) => any;
     "update:value": (value: OptionValue | OptionValueList | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSearch?: ((keyword: string) => any) | undefined;
     "onUpdate:value"?: ((value: OptionValue | OptionValueList | null) => any) | undefined;
 }>, {
+    mode: "multiple";
     disabled: boolean;
     loading: boolean;
     value: OptionValue | OptionValueList | null;
     placeholder: string;
     allowClear: boolean;
-    mode: "multiple";
+    showSearch: boolean;
+    filterTreeNode: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/vue-ui-antdv/index.d.ts

@@ -11,6 +11,7 @@ export { default as UiSearchInput } from './components/UiSearchInput.vue';
 export { default as UiTextArea } from './components/UiTextArea.vue';
 export { default as UiSelect } from './components/UiSelect.vue';
 export { default as UiTreeSelect } from './components/UiTreeSelect.vue';
+export type { UiTreeSelectNode } from './components/UiTreeSelect.vue';
 export { default as UiTooltip } from './components/UiTooltip.vue';
 export { default as UiThemeProvider } from './components/UiThemeProvider.vue';
 export { default as UiSwitch } from './components/UiSwitch.vue';

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

@@ -69,6 +69,37 @@ export interface WebUserNotification {
     logoutRequired?: boolean;
     targetSessionId?: string;
 }
+/** Ephemeral business reminder. It is not a persisted inbox or an acknowledgement record. */
+export interface WebBusinessNotification {
+    id: string;
+    code: string;
+    title: string;
+    subtitle?: string;
+    content: string;
+    dismissible: boolean;
+    actions: WebBusinessNotificationAction[];
+}
+export type WebBusinessNotificationAction = WebBusinessNotificationNavigateAction | WebBusinessNotificationCommandAction;
+export interface WebBusinessNotificationNavigateAction {
+    kind: 'navigate';
+    key: string;
+    label: string;
+    moduleAlias: string;
+    recordId?: string;
+    pageMode?: 'LIST' | 'FORM' | 'DETAIL';
+    query?: Record<string, string>;
+    dismissOnSuccess: boolean;
+}
+export interface WebBusinessNotificationCommandAction {
+    kind: 'command';
+    key: string;
+    label: string;
+    command: string;
+    arguments?: Record<string, unknown>;
+    danger?: boolean;
+    confirmation?: string;
+    dismissOnSuccess: boolean;
+}
 export interface WebBusinessRealtimeEvent {
     type: string;
     moduleAlias: string;
@@ -92,6 +123,8 @@ export interface RecordInlineAction {
     iconName?: RecordInlineActionIconName;
     showLabel?: boolean;
     disabled?: boolean;
+    /** Explains why a visible inline action is unavailable. */
+    disabledReason?: string;
     danger?: boolean;
 }
 export type RecordInlineActionIconName = 'app' | 'check' | 'close' | 'delete' | 'down' | 'edit' | 'export' | 'filter' | 'help' | 'lock' | 'notification' | 'plus' | 'power' | 'reload' | 'save' | 'search' | 'settings';
@@ -497,9 +530,73 @@ export interface ResolvedViewDescriptor {
     fields: ResolvedViewFieldDescriptor[];
     /** Dynamic-page provenance used to select the view configured by a menu entry. */
     sourceUiConfigId?: string;
-    scopedListWorkspace?: ResolvedScopedListWorkspaceDescriptor;
     formGroups?: FormGroupDescriptor[];
 }
+export type ModulePageTemplate = 'FLAT_MANAGEMENT' | 'LIST_DETAIL_CARD' | 'TREE_MANAGEMENT';
+export interface ResolvedPageExplorerDescriptor {
+    title: string;
+    searchPlaceholder: string;
+    emptyDescription: string;
+    recordLabel: string;
+    fallbackTitle: string;
+    titleField: string;
+    secondaryField?: string;
+    mutedWhenDisabled: boolean;
+}
+export interface ResolvedPageNavigatorDescriptor {
+    levels: ResolvedPageNavigatorLevelDescriptor[];
+    contextBindings: ResolvedPageContextBindingDescriptor[];
+}
+export interface ResolvedPageNavigatorLevelDescriptor {
+    key: string;
+    kind: 'TREE' | 'MICRO_LIST';
+    sourceModuleAlias: string;
+    title: string;
+    searchPlaceholder: string;
+    /** Presentation policy applied after the source has authoritatively loaded. */
+    singleResultPolicy?: 'NONE' | 'AUTO_SELECT' | 'AUTO_SELECT_AND_HIDE';
+    /** Session-derived source scope, enforced by the source reference transport. */
+    sourceScope?: 'NONE' | 'CURRENT_TENANT';
+    /** When present, the navigator source exposes its own standard CRUD affordances in place. */
+    management?: ResolvedPageNavigatorManagementDescriptor;
+}
+export interface ResolvedPageContextBindingDescriptor {
+    source: 'SESSION' | 'NAVIGATOR';
+    sourceKey: string;
+    target: 'LIST_QUERY' | 'NAVIGATOR_QUERY' | 'FORM_DEFAULT' | 'PICKER_QUERY' | 'MUTATION_CONSTRAINT';
+    targetKey: string;
+    targetNavigatorLevelKey?: string;
+    /** Field name of the record picker which receives this query context. */
+    targetPickerFieldKey?: string;
+}
+export interface ResolvedPageNavigatorManagementDescriptor {
+    /** Optional named source-module form; the default editor is used when omitted. */
+    editorSurface?: string;
+}
+export interface ResolvedPageListDescriptor {
+    searchPlaceholder: string;
+    fields: ResolvedViewDescriptor;
+}
+export interface ResolvedPageDetailDescriptor {
+    emptyDescription: string;
+    createTitle: string;
+    display?: ResolvedViewDescriptor;
+    /** Omitted by an editorless page; standard mutation actions remain governed by the runtime action contract. */
+    editor?: ResolvedViewDescriptor;
+    /** Stable client registration key for an independently restorable detail workbench view. */
+    workspaceView?: ResolvedPageDetailWorkspaceViewDescriptor;
+}
+export interface ResolvedPageDetailWorkspaceViewDescriptor {
+    type: string;
+}
+export interface ResolvedModulePageDescriptor {
+    template: ModulePageTemplate;
+    explorer?: ResolvedPageExplorerDescriptor;
+    navigator?: ResolvedPageNavigatorDescriptor;
+    list?: ResolvedPageListDescriptor;
+    detail: ResolvedPageDetailDescriptor;
+    traits: ('STANDARD_CRUD' | 'ENABLED_STATUS' | 'RECYCLE_BIN' | 'RESPONSIVE_DETAIL_SURFACE')[];
+}
 export interface ResolvedUiActionConfirmationDescriptor {
     mode: 'typedText';
     requiredField: string;
@@ -508,17 +605,6 @@ export interface ResolvedUiActionDescriptor {
     actionCode: string;
     confirmation?: ResolvedUiActionConfirmationDescriptor;
 }
-export interface ResolvedScopedListWorkspaceDescriptor {
-    scopeModuleAlias: string;
-    scopeField: string;
-    queryCriteriaKey: string;
-    scopeTitle: string;
-    scopeSearchPlaceholder: string;
-    /** Scope list items only show a secondary label when the descriptor explicitly enables it. */
-    showScopeItemSubtitle: boolean;
-    createPolicy: 'REQUIRE_SCOPE' | 'ALLOW_UNSCOPED';
-    manageScopeTree?: boolean;
-}
 /** Source-neutral runtime fact for one persisted MuYunFileServer field. */
 export interface ResolvedFileReferenceFieldDescriptor {
     fieldRef: ViewFieldRef;
@@ -529,19 +615,26 @@ export interface ResolvedFileReferenceFieldDescriptor {
     uploadAvailable: boolean;
     readAvailable: boolean;
 }
-export interface ModuleUiDefinition {
-    moduleAlias: string;
-    views: ViewDefinition[];
-}
 export interface ResolvedModuleUiDescriptor {
     schemaVersion: string;
     moduleAlias: string;
     moduleKind?: 'STATIC' | 'DYNAMIC';
     title?: string;
-    views: ResolvedViewDescriptor[];
     actions?: ResolvedUiActionDescriptor[];
     recordLabelField?: string;
     fileReferences?: ResolvedFileReferenceFieldDescriptor[];
+    page?: ResolvedModulePageDescriptor;
+    defaultEditor?: ResolvedViewDescriptor;
+    editorSurfaces?: ResolvedEditorSurfaceDescriptor[];
+    editorContributions?: ResolvedPageDetailEditorContribution[];
+}
+export interface ResolvedEditorSurfaceDescriptor {
+    key: string;
+    editor: ResolvedViewDescriptor;
+}
+export interface ResolvedPageDetailEditorContribution {
+    resource: string;
+    editor: ResolvedViewDescriptor;
 }
 export interface StandardEntity {
     id?: string;

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

@@ -0,0 +1,3 @@
+import type { WebBusinessNotificationCommandAction } from '../web-contracts/index';
+import type { HttpClient } from './http';
+export declare function invokeBusinessNotificationCommand(http: HttpClient, notificationId: string, action: WebBusinessNotificationCommandAction): Promise<unknown>;

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

@@ -2,6 +2,7 @@ export * from './errors';
 export * from './http';
 export * from './query';
 export * from './actionResult';
+export * from './businessNotifications';
 export * from './dataChanges';
 export * from './realtime';
 export * from './clients';

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

@@ -23,6 +23,7 @@ export interface ModuleContextConfig {
 }
 export interface ModuleContextOptions extends ModuleContextConfig {
     moduleAlias: string;
+    runtimeAccess?: 'MENU' | 'REFERENCE';
 }
 export declare function configureModuleContext(config: ModuleContextConfig): void;
 export declare function provideModuleContextConfig(config: ModuleContextConfig): void;

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

@@ -47,6 +47,8 @@ export interface ModuleRuntimeContext {
     capabilities: string[];
     abilities?: string[];
     actions: ModuleRuntimeAction[];
+    /** Read-only projections this module deliberately exposes for page navigation. */
+    navigatorSourceCapabilities?: Array<'REFERENCE_QUERY' | 'REFERENCE_TREE'>;
     uiDescriptor?: ResolvedModuleUiDescriptor;
 }
 export interface ModuleRuntimeContextState {
@@ -61,5 +63,5 @@ export interface ModuleRuntimeContextState {
     recordActions(recordId: string): Promise<ModuleRecordActionAvailability>;
     recordActionsSnapshot(recordId: string): ModuleRecordActionAvailability | undefined;
 }
-export declare function createModuleRuntimeContextState(http: HttpClient, moduleAlias: string): ModuleRuntimeContextState;
+export declare function createModuleRuntimeContextState(http: HttpClient, moduleAlias: string, access?: 'MENU' | 'REFERENCE'): ModuleRuntimeContextState;
 export declare function isRuntimeAbilityAvailable(context: ModuleRuntimeContext | undefined, ability: ModuleAbilityCode): boolean;

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

@@ -22,7 +22,7 @@ export interface StaticModuleCrudClient<TRecord> {
     disable(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
 }
 export interface StaticModuleTreeClient<TRecord> extends StaticModuleCrudClient<TRecord> {
-    tree(): Promise<WebListResponse<WebTreeNode<TRecord>>>;
+    tree(request?: WebQueryRequest): Promise<WebListResponse<WebTreeNode<TRecord>>>;
     treeFlat(options?: {
         rootId?: string;
         includeSelf?: boolean;
@@ -39,8 +39,15 @@ export interface ModuleEnableClient {
 export declare function createStaticModuleCrudClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
 }): StaticModuleCrudClient<TRecord>;
+/** The navigation-only read surface deliberately does not reuse the module query endpoint. */
+export declare function createNavigatorReferenceCrudClient<TRecord>(http: HttpClient, options: {
+    moduleAlias: string;
+}): StaticModuleCrudClient<TRecord>;
 export declare function createStaticResourceCrudClient<TRecord>(http: HttpClient, resourcePath: string): StaticModuleCrudClient<TRecord>;
 export declare function createStaticModuleTreeClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
 }): StaticModuleTreeClient<TRecord>;
+export declare function createNavigatorReferenceTreeClient<TRecord>(http: HttpClient, options: {
+    moduleAlias: string;
+}): StaticModuleTreeClient<TRecord>;
 export declare function createStaticResourceTreeClient<TRecord>(http: HttpClient, resourcePath: string): StaticModuleTreeClient<TRecord>;

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

@@ -1,5 +1,5 @@
 import { type IMessage } from '@stomp/stompjs';
-import type { WebBusinessRealtimeEvent, WebCommittedChangeSet, WebRealtimeEnvelope, WebUserNotification } from '../web-contracts/index';
+import type { WebBusinessRealtimeEvent, WebBusinessNotification, WebCommittedChangeSet, WebRealtimeEnvelope, WebUserNotification } from '../web-contracts/index';
 import type { DataChangeDispatcher } from './dataChanges';
 export type RealtimeConnectionState = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'disconnected' | 'unauthorized' | 'failed';
 export interface RealtimeChannel<TPayload> {
@@ -66,11 +66,13 @@ export interface StompErrorFrame {
 export declare const realtimeMessageTypes: {
     readonly dataChange: "platform.data-change";
     readonly securityNotification: "platform.security-notification";
+    readonly businessNotification: "platform.business-notification";
     readonly businessEvent: "platform.business-event";
 };
 export declare const realtimeDestinations: {
     readonly userDataChanges: "/user/queue/platform/data-changes";
     readonly userNotifications: "/user/queue/platform/notifications";
+    readonly userBusinessNotifications: "/user/queue/platform/business-notifications";
     readonly userBusinessEvents: "/user/queue/platform/business-events";
     readonly userImMessages: "/user/queue/platform/im/messages";
     readonly platformPing: "/app/platform/ping";
@@ -79,6 +81,7 @@ export declare const realtimeDestinations: {
 };
 export declare const dataChangeChannel: RealtimeChannel<WebCommittedChangeSet>;
 export declare const userNotificationChannel: RealtimeChannel<WebUserNotification>;
+export declare const userBusinessNotificationChannel: RealtimeChannel<WebBusinessNotification>;
 export declare const userBusinessEventChannel: RealtimeChannel<WebBusinessRealtimeEvent>;
 export declare const userImMessageChannel: RealtimeChannel<unknown>;
 export declare const platformPingCommand: RealtimeCommand<{
@@ -101,4 +104,5 @@ export declare function imConversationMessageChannel(conversationId: string): Re
 export declare function createRealtimeClient(options?: RealtimeClientOptions): RealtimeClient;
 export declare function connectRealtimeDataChanges(realtime: RealtimeClient, dispatcher: DataChangeDispatcher): RealtimeSubscription;
 export declare function connectRealtimeUserNotifications(realtime: RealtimeClient, handler: RealtimeHandler<WebUserNotification>): RealtimeSubscription;
+export declare function connectRealtimeBusinessNotifications(realtime: RealtimeClient, handler: RealtimeHandler<WebBusinessNotification>): RealtimeSubscription;
 export declare function connectRealtimeBusinessEvents(realtime: RealtimeClient, handler: RealtimeHandler<WebBusinessRealtimeEvent>): RealtimeSubscription;