@ximatai/muyun-web-app 0.26.6 → 0.26.8

package/dist/types/app/CurrentUserProfileDialog.vue.d.ts

@@ -0,0 +1,33 @@
+import type { ModuleContext } from '../web-core/index';
+import type { CurrentUserProfile } from '../web-contracts/index';
+type __VLS_Props = {
+    open?: boolean;
+    profile?: CurrentUserProfile;
+    loading?: boolean;
+    saving?: boolean;
+    error?: string;
+    avatarContext: ModuleContext<unknown>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+    submit: (value: {
+        mobile: string;
+        email: string;
+        avatarAssetId?: string;
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onSubmit?: ((value: {
+        mobile: string;
+        email: string;
+        avatarAssetId?: string;
+    }) => any) | undefined;
+}>, {
+    loading: boolean;
+    open: boolean;
+    error: string;
+    profile: CurrentUserProfile;
+    saving: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/app/LoginView.vue.d.ts

@@ -1,9 +1,12 @@
-import type { AuthClient } from '../web-core/index';
+import type { AuthClient, LoginContextClient } from '../web-core/index';
 import type { LoginResult } from '../web-contracts/index';
 type __VLS_Props = {
     authClient: AuthClient;
+    loginContextClient?: LoginContextClient;
     loading?: boolean;
     error?: string;
+    /** Used only when the form is first created; URL-locked tenants always take precedence. */
+    initialUsername?: string;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     authenticated: (result: LoginResult) => any;

package/dist/types/app/ThemeSkinPreferencesDialog.vue.d.ts

@@ -0,0 +1,20 @@
+import { type UiThemeSkin, type UiThemeSkinId } from '../vue-ui-antdv/index';
+type __VLS_Props = {
+    open: boolean;
+    skins: readonly UiThemeSkin[];
+    activeSkinId: UiThemeSkinId;
+    saving?: boolean;
+    error?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+    select: (skinId: UiThemeSkinId) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onSelect?: ((skinId: UiThemeSkinId) => any) | undefined;
+}>, {
+    error: string;
+    saving: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/app/lockedTabPreference.d.ts

@@ -0,0 +1,6 @@
+import type { MenuTab } from '../web-contracts/index';
+import type { UserPreferenceStore } from '../web-core/index';
+export declare const lockedTabPreferenceKey = "workbench.locked-tabs";
+export declare function restoreLockedTabPreference(store: UserPreferenceStore): Promise<MenuTab[]>;
+export declare function saveLockedTabPreference(store: UserPreferenceStore, tabs: MenuTab[]): Promise<void>;
+export declare function normalizeLockedTabs(value: unknown): MenuTab[];

package/dist/types/app/themeSkinPreference.d.ts

@@ -0,0 +1,11 @@
+import { type UiThemeSkinId } from '../vue-ui-antdv/index';
+import type { UserPreferenceStore } from '../web-core/index';
+export declare const themeSkinPreferenceKey = "workbench.theme-skin";
+export declare function restoreThemeSkinPreference(store: UserPreferenceStore, fallback: UiThemeSkinId): Promise<UiThemeSkinId>;
+export declare function saveThemeSkinPreference(store: UserPreferenceStore, skinId: UiThemeSkinId, previousSkinId: UiThemeSkinId): Promise<{
+    skinId: UiThemeSkinId;
+    error?: undefined;
+} | {
+    skinId: UiThemeSkinId;
+    error: string;
+}>;

package/dist/types/app/workbenchStartup.d.ts

@@ -1,5 +1,5 @@
 import type { MenuClient, SessionClient } from '../web-core/index';
-import type { MenuNavigationTarget, MenuRecord, MenuTab, PageDescriptor, WorkbenchStartupState } from '../web-contracts/index';
+import type { MenuNavigationTarget, MenuRecord, MenuTab, MenuTreeNode, PageDescriptor, WorkbenchStartupState } from '../web-contracts/index';
 import { type PageDescriptorResolveOptions } from '../platform-workbench/index';
 export interface WorkbenchStartupClients {
     sessionClient: SessionClient;
@@ -22,3 +22,20 @@ export declare function closeMenuTab(tabs: MenuTab[], activeTabKey: string | und
     tabs: MenuTab[];
     activeTabKey: string | undefined;
 };
+/** Closes the selected closable tabs and chooses the nearest remaining tab when the active one closes. */
+export declare function closeMenuTabs(tabs: MenuTab[], activeTabKey: string | undefined, closedTabKeys: string[]): {
+    tabs: MenuTab[];
+    activeTabKey: string | undefined;
+};
+/** Keeps account-pinned tabs at the left while ordinary tab order remains a browser-session concern. */
+export declare function arrangeLockedMenuTabs(tabs: MenuTab[], lockedTabs: MenuTab[], includeMissingLockedTabs?: boolean): MenuTab[];
+/**
+ * Restores account-locked tabs from two authority-checked sources only:
+ * currently visible tab menus and registered, URL-restorable workspace views.
+ * Arbitrary stored routes are deliberately not revived.
+ */
+export declare function restoreLockedWorkbenchTabs(lockedTabs: MenuTab[], menus: MenuTreeNode[], options?: PageDescriptorResolveOptions): MenuTab[];
+export declare function updateLockedMenuTabs(lockedTabs: MenuTab[], tab: MenuTab): MenuTab[];
+export declare function removeLockedMenuTabs(lockedTabs: MenuTab[], keys: string[]): MenuTab[];
+/** Reorders the open tabs for the current browser session without affecting URL restoration. */
+export declare function reorderMenuTabs(tabs: MenuTab[], keys: string[], lockedTabKeys?: string[]): MenuTab[];

package/dist/types/consumer/AppWorkbenchShell.vue.d.ts

@@ -0,0 +1,43 @@
+import type { PageDescriptor, WorkbenchStartupState } from '../web-contracts';
+import { type PageDescriptorResolveOptions } from '../platform-workbench/menuNavigation';
+import type { WorkbenchRealtimeStatus } from '../platform-workbench/realtimeStatus';
+import type { AppWorkbenchNavigation } from './workbenchNavigation';
+type __VLS_Props = {
+    startup: WorkbenchStartupState;
+    /** The consumer router's current full path, including search and hash. */
+    location: string;
+    resolveOptions?: PageDescriptorResolveOptions;
+    loading?: boolean;
+    error?: string;
+    realtimeStatus?: WorkbenchRealtimeStatus;
+    themeAppearance?: 'light' | 'dark';
+};
+declare var __VLS_17: {
+    pageDescriptor: PageDescriptor | undefined;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_17) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    navigate: (navigation: AppWorkbenchNavigation) => any;
+    userCommand: (key: string) => any;
+    "update:startup": (value: WorkbenchStartupState) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onNavigate?: ((navigation: AppWorkbenchNavigation) => any) | undefined;
+    onUserCommand?: ((key: string) => any) | undefined;
+    "onUpdate:startup"?: ((value: WorkbenchStartupState) => any) | undefined;
+}>, {
+    loading: boolean;
+    error: string;
+    realtimeStatus: WorkbenchRealtimeStatus;
+    themeAppearance: "light" | "dark";
+    resolveOptions: PageDescriptorResolveOptions;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/consumer/index.d.ts

@@ -5,19 +5,34 @@
  *
  * Consumers must import `@ximatai/muyun-web-app/style.css` explicitly.
  */
+import '../vue-ui-antdv/styles.css';
 import '../styles.css';
 export * from '../web-contracts/index';
 export * from '../web-core/index';
 export * from '../platform-workbench/index';
 export * from '../platform-admin-runtime/index';
+export { activeTabUrlOf, arrangeLockedMenuTabs, removeLockedMenuTabs, restoreWorkbenchStartupStateFromUrl, restoreLockedWorkbenchTabs, updateLockedMenuTabs, } from '../app/workbenchStartup';
+export { restoreLockedTabPreference, saveLockedTabPreference } from '../app/lockedTabPreference';
 export { configureModulePageEnhancements, createModulePageEnhancementRegistry, modulePageWorkspaceViews, } from '../dynamic-page-runtime/modulePageEnhancements';
 export { refreshModulePageList } from '../dynamic-page-runtime/modulePageListRefresh';
-export type { ModuleListEnhancement, ModuleDetailEnhancement, ModulePageActionContext, ModulePageActionContribution, ModulePageBatchActionContext, ModulePageBatchActionContribution, ModulePageColumnContribution, ModulePageDetailSection, ModulePageDetailSectionContext, ModulePageDrawer, ModulePageDrawerContext, ModulePageEnhancement, ModulePageEnhancementTarget, ModulePageRecordActionContext, ModulePageRecordActionContribution, ModulePageWorkspaceView, ModulePageWorkspaceViewInput, } from '../dynamic-page-runtime/modulePageEnhancements';
-export { UiButton, confirmAction, UiDataTable, UiInput, UiSidePanel, UiSwitch, UiTextArea, UiTree, } from '../vue-ui-antdv/index';
+export type { ModuleListEnhancement, ModuleDetailEnhancement, ModulePageActionContext, ModulePageActionContribution, ModulePageActionStateContext, ModulePageBatchActionContext, ModulePageBatchActionContribution, ModulePageColumnContribution, ModulePageDetailDrawer, ModulePageDetailSection, ModulePageDetailSectionContext, ModulePageDrawer, ModulePageDrawerContext, ModulePageEnhancement, ModulePageEnhancementTarget, ModulePageRecordActionContext, ModulePageRecordActionContribution, ModulePageScopeContext, ModulePageWorkspaceView, ModulePageWorkspaceViewInput, } from '../dynamic-page-runtime/modulePageEnhancements';
+export { UiButton, confirmAction, UiDataTable, UiInput, UiSidePanel, UiSwitch, UiTextArea, UiTree, UiTreeSelect, } from '../vue-ui-antdv/index';
 export { default as PlatformAdminOutlet } from './PlatformAdminOutlet.vue';
+export { default as AppWorkbenchShell } from './AppWorkbenchShell.vue';
+export { default as LoginView } from '../app/LoginView.vue';
+export type { AppWorkbenchNavigation } from './workbenchNavigation';
+export { configureUserPreferencePersistence } from './userPreferencePersistence';
+export { default as ChangeOwnPasswordDialog } from '../app/ChangeOwnPasswordDialog.vue';
+export { default as ThemeSkinPreferencesDialog } from '../app/ThemeSkinPreferencesDialog.vue';
+export { restoreThemeSkinPreference, saveThemeSkinPreference, themeSkinPreferenceKey, } from '../app/themeSkinPreference';
+export { defaultUiThemeSkinId, UiThemeProvider, uiThemeSkinById, uiThemeSkins } from '../vue-ui-antdv/index';
+export type { UiThemeSkin, UiThemeSkinId } from '../vue-ui-antdv/index';
 export { default as DateTimeText } from '../platform-components/DateTimeText.vue';
 export { default as FileSizeText } from '../platform-components/FileSizeText.vue';
+export { default as DynamicModuleWorkspaceDetailView } from '../dynamic-page-runtime/DynamicModuleWorkspaceDetailView.vue';
 export { default as FileTransferUploader } from '../platform-components/FileTransferUploader.vue';
+export { default as SingleImageFileReferenceField } from '../platform-components/SingleImageFileReferenceField.vue';
+export { uploadedFileId } from '../platform-components/fileReferenceTransfer';
 export { presentPlatformError, presentPlatformInfo, presentPlatformMessage, presentPlatformSuccess, } from '../platform-components/platformErrorFeedback';
 export { createBrowserFileTransferUpload, unwrapResponsePayload, } from '../platform-components/fileTransferUpload';
 export type { FileTransferUploadAccess, FileTransferUploadReceipt, FileTransferUploadTask, } from '../platform-components/fileTransferUpload';

package/dist/types/consumer/userPreferencePersistence.d.ts

@@ -0,0 +1,7 @@
+import type { HttpClient } from '../web-core/http';
+/**
+ * Connects the consumer App's authenticated HTTP factory to the platform's
+ * account-scoped preference endpoints. Consumers retain ownership of their
+ * authentication lifecycle without depending on web-core's internal bridge.
+ */
+export declare function configureUserPreferencePersistence(httpFactory: () => HttpClient): void;

package/dist/types/consumer/workbenchNavigation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A workbench navigation request. The consuming App owns the router and must
+ * apply this request with its own `router.push` or `router.replace`.
+ */
+export interface AppWorkbenchNavigation {
+    url: string;
+    mode: 'push' | 'replace';
+}

package/dist/types/dynamic-page-runtime/DynamicModuleWorkspaceDetailView.vue.d.ts

@@ -0,0 +1,10 @@
+type __VLS_Props = {
+    recordId: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "close-workspace": () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onClose-workspace"?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/dynamic-page-runtime/DynamicRecordDetailActions.vue.d.ts

@@ -0,0 +1,38 @@
+import { type RecordActionItem, type QueryListRecord } from '../platform-components/index';
+import type { ModuleContext } from '../web-core/index';
+import type { ModulePageRecordActionContribution } from './modulePageEnhancements';
+type __VLS_Props = {
+    context: ModuleContext<QueryListRecord>;
+    record?: QueryListRecord;
+    mode: 'create' | 'edit' | 'view';
+    saving?: boolean;
+    detailLoading?: boolean;
+    detailLoadFailed?: boolean;
+    recycleBinActive?: boolean;
+    actions?: ModulePageRecordActionContribution[];
+    /** Custom record views retain their own operation model. */
+    showStandardViewActions?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    delete: () => any;
+    edit: () => any;
+    save: () => any;
+    cancel: () => any;
+    detailAction: (action: RecordActionItem) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDelete?: (() => any) | undefined;
+    onEdit?: (() => any) | undefined;
+    onSave?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
+    onDetailAction?: ((action: RecordActionItem) => any) | undefined;
+}>, {
+    actions: ModulePageRecordActionContribution[];
+    record: QueryListRecord;
+    saving: boolean;
+    detailLoading: boolean;
+    detailLoadFailed: boolean;
+    recycleBinActive: boolean;
+    showStandardViewActions: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/dynamic-page-runtime/NavigatorManagementEditor.vue.d.ts

@@ -0,0 +1,25 @@
+import { type RecordFormFieldPickerConfig, type RecordFormFieldValue, type RecordFormRecord } from '../platform-components/index';
+import type { ModuleContext } from '../web-core/index';
+type __VLS_Props = {
+    open: boolean;
+    title: string;
+    saving: boolean;
+    loading: boolean;
+    loadFailed: boolean;
+    draft?: RecordFormRecord;
+    fields: ReturnType<typeof import('../platform-components/index').resolveRecordFormFields>;
+    formSessionKey: number;
+    context: ModuleContext<unknown>;
+    pickerConfigs: Record<string, RecordFormFieldPickerConfig>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+    save: () => any;
+    updateField: (fieldName: string, value: RecordFormFieldValue) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onSave?: (() => any) | undefined;
+    onUpdateField?: ((fieldName: string, value: RecordFormFieldValue) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/dynamic-page-runtime/PageNavigatorExplorer.vue.d.ts

@@ -0,0 +1,43 @@
+import { type QueryListRecord } from '../platform-components/index';
+import type { RecordInlineAction, ResolvedPageNavigatorLevelDescriptor } from '../web-contracts/index';
+import type { ModuleContext } from '../web-core/index';
+type NavigatorLevelRuntime = {
+    descriptor: ResolvedPageNavigatorLevelDescriptor;
+    context: ModuleContext<QueryListRecord>;
+    tree: boolean;
+};
+type __VLS_Props = {
+    level: NavigatorLevelRuntime;
+    selectedId?: string;
+    reloadKey: number;
+    keyword: string;
+    externalQueryValues?: Record<string, unknown>;
+    actionsOf?: () => RecordInlineAction[];
+};
+declare var __VLS_38: {};
+type __VLS_Slots = {} & {
+    editor?: (props: typeof __VLS_38) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (record: QueryListRecord) => any;
+    action: (action: RecordInlineAction, record: QueryListRecord) => any;
+    create: () => any;
+    refresh: () => any;
+    loaded: (records: QueryListRecord[]) => any;
+    "update:keyword": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((record: QueryListRecord) => any) | undefined;
+    onAction?: ((action: RecordInlineAction, record: QueryListRecord) => any) | undefined;
+    onCreate?: (() => any) | undefined;
+    onRefresh?: (() => any) | undefined;
+    onLoaded?: ((records: QueryListRecord[]) => any) | undefined;
+    "onUpdate:keyword"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,10 @@
+import type { UserPreferenceStore } from '../web-core/index';
+export type DetailSurfacePreference = 'drawer' | 'pinned';
+export declare function detailSurfacePreferenceKey(moduleAlias: string): string;
+export declare function normalizeDetailSurfacePreference(value: unknown): DetailSurfacePreference | undefined;
+/**
+ * Restores an account-scoped choice while retaining the device-local value as
+ * a resilient fallback when the preference service is temporarily unavailable.
+ */
+export declare function restoreDetailSurfacePreference(store: UserPreferenceStore, moduleAlias: string): Promise<DetailSurfacePreference | undefined>;
+export declare function saveDetailSurfacePreference(store: UserPreferenceStore, moduleAlias: string, preference: DetailSurfacePreference): Promise<void>;

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

@@ -1,8 +1,9 @@
 export { default as DynamicModuleHost } from './DynamicModuleHost.vue';
 export { default as DynamicModulePage } from './DynamicModulePage.vue';
+export { default as DynamicModuleWorkspaceDetailView } from './DynamicModuleWorkspaceDetailView.vue';
 export { customerDescriptor } from './mockDescriptor';
 export { configureModulePageEnhancements, createModulePageEnhancementRegistry, modulePageWorkspaceViews, resolveModulePageEnhancement, } from './modulePageEnhancements';
 export { provideModulePageNavigation, useModulePageNavigation } from './modulePageNavigation';
 export { createModulePageListRefreshRegistry, modulePageListRefreshRegistry, refreshModulePageList, } from './modulePageListRefresh';
 export type { ModulePageListRefreshRegistry } from './modulePageListRefresh';
-export type { ModuleListEnhancement, ModuleDetailEnhancement, ModulePageActionContext, ModulePageActionContribution, ModulePageBatchActionContext, ModulePageBatchActionContribution, ModulePageColumnContribution, ModulePageDetailSection, ModulePageDetailSectionContext, ModulePageDrawer, ModulePageDrawerContext, ModulePageEnhancement, ModulePageEnhancementRegistry, ModulePageEnhancementTarget, ModulePageRecordActionContext, ModulePageRecordActionContribution, ModulePageWorkspaceView, ModulePageWorkspaceViewInput, } from './modulePageEnhancements';
+export type { ModuleListEnhancement, ModuleDetailEnhancement, ModulePageActionContext, ModulePageActionContribution, ModulePageActionStateContext, ModulePageBatchActionContext, ModulePageBatchActionContribution, ModulePageColumnContribution, ModulePageDetailDrawer, ModulePageDetailSection, ModulePageDetailSectionContext, ModulePageDrawer, ModulePageDrawerContext, ModulePageEnhancement, ModulePageEnhancementRegistry, ModulePageEnhancementTarget, ModulePageRecordActionContext, ModulePageRecordActionContribution, ModulePageScopeContext, ModulePageWorkspaceView, ModulePageWorkspaceViewInput, } from './modulePageEnhancements';

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

@@ -14,6 +14,14 @@ export interface ModulePageEnhancement {
     target: ModulePageEnhancementTarget;
     list?: ModuleListEnhancement;
     detail?: ModuleDetailEnhancement;
+    /**
+     * The presentation selected when a user invokes the standard record-view intent.
+     *
+     * Both the platform "查看" action and a list double-click enter the same record
+     * view flow. Applications may replace only the drawer body, while the runtime
+     * retains that flow's action checks, shell and lifecycle.
+     */
+    recordView?: ModulePageRecordView;
     workspaceViews?: ModulePageWorkspaceView[];
 }
 export interface ModulePageEnhancementTarget {
@@ -36,14 +44,36 @@ export interface ModuleDetailEnhancement {
     actions?: ModulePageRecordActionContribution[];
     sections?: ModulePageDetailSection[];
 }
+/** Application-owned presentation of the platform's standard record-view intent. */
+export interface ModulePageRecordView {
+    /**
+     * Replaces the descriptor-generated detail body while retaining the platform
+     * view drawer, its list entry points, and its lifecycle.
+     *
+     * A custom drawer body is intentionally read-only from the platform's point
+     * of view: generic edit and enable/disable controls are withheld so that the
+     * business module owns every operation it exposes in the view.
+     */
+    drawer: ModulePageDetailDrawer;
+    /**
+     * Optional record-level business grant required in addition to the standard
+     * view entry point. This protects business drawer data without turning its
+     * custom endpoints into a second "查看" UI action.
+     */
+    authorizationActionCode?: string;
+}
 export interface ModulePageActionContribution extends RecordActionItem {
     key: string;
+    /** Authorizes this toolbar action against the selected scoped-list record instead of the page module. */
+    authorization?: 'scope-record';
+    /** Derives the action state from the current scoped-list selection when the page has one. */
+    state?(context: ModulePageActionStateContext): Partial<Pick<RecordActionItem, 'visible' | 'disabled' | 'disabledReason'>> | undefined;
     run(context: ModulePageActionContext): void | Promise<void>;
 }
 export interface ModulePageRecordActionContribution extends RecordActionItem {
     key: string;
     /** Resolves record-specific visibility or enabled state without letting business code own the table shell. */
-    state?(record: QueryListRecord): Pick<RecordActionItem, 'visible' | 'disabled'> | undefined;
+    state?(record: QueryListRecord): Partial<Pick<RecordActionItem, 'visible' | 'disabled'>> | undefined;
     run(context: ModulePageRecordActionContext): void | Promise<void>;
 }
 export interface ModulePageBatchActionContribution extends RecordActionItem {
@@ -55,6 +85,18 @@ export interface ModulePageDetailSection {
     title: string;
     component: Component;
 }
+/** Business content rendered inside the platform-owned standard view drawer. */
+export interface ModulePageDetailDrawer {
+    /** The component receives only the documented ModulePageDrawerContext prop. */
+    component: Component;
+    /** Keeps the platform drawer shell while allowing dense business views more room. */
+    width?: number | string;
+    /**
+     * 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.
+     */
+    loadRecord?: boolean;
+}
 export interface ModulePageColumnContribution extends RecordQueryListColumn {
     key: string;
     /** Insert adjacent to a descriptor column. Omit to append after descriptor columns. */
@@ -88,6 +130,8 @@ export interface ModulePageWorkspaceView<TInput extends ModulePageWorkspaceViewI
 export interface ModulePageDrawerContext {
     module: ModuleContext<QueryListRecord>;
     record?: QueryListRecord;
+    /** The currently selected scope record for a scoped list workspace, if applicable. */
+    scope?: ModulePageScopeContext;
     /** Reloads only the current list query and preserves its query and editor state. */
     refreshList(): void;
     close(): void;
@@ -95,12 +139,24 @@ export interface ModulePageDrawerContext {
 }
 export interface ModulePageActionContext {
     module: ModuleContext<QueryListRecord>;
+    /** The currently selected scope record for a scoped list workspace, if applicable. */
+    scope?: ModulePageScopeContext;
     /** Reloads only the current list query and preserves its query and editor state. */
     refreshList(): void;
     openDrawer(drawer: ModulePageDrawer): void;
     openWorkspaceTab<TInput extends ModulePageWorkspaceViewInput>(view: ModulePageWorkspaceView<TInput>, input: TInput): void;
     reload(): void;
 }
+/** Read-only scope state supplied by a descriptor-owned scoped list workspace. */
+export interface ModulePageScopeContext {
+    moduleAlias: string;
+    record?: QueryListRecord;
+}
+/** Small state-only context used while resolving a toolbar action's visibility or enabled state. */
+export interface ModulePageActionStateContext {
+    module: ModuleContext<QueryListRecord>;
+    scope?: ModulePageScopeContext;
+}
 export interface ModulePageRecordActionContext extends ModulePageActionContext {
     record: QueryListRecord;
 }

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

@@ -5,7 +5,7 @@ export interface ModulePageNavigation {
     openPage(descriptor: PageDescriptor): {
         created: boolean;
     };
-    openWorkspaceTab<TInput extends ModulePageWorkspaceViewInput>(view: ModulePageWorkspaceView<TInput>, input: TInput): void;
+    openWorkspaceTab<TInput extends ModulePageWorkspaceViewInput>(view: ModulePageWorkspaceView<TInput>, input: TInput, title?: string): void;
 }
 export declare function provideModulePageNavigation(navigation: ModulePageNavigation | undefined): void;
 export declare function useModulePageNavigation(): ModulePageNavigation | undefined;

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

@@ -0,0 +1,6 @@
+import type { ResolvedPageContextBindingDescriptor } from '../web-contracts/index';
+export type PageContextSourceValues = Partial<Record<ResolvedPageContextBindingDescriptor['source'], Record<string, unknown>>>;
+/** Returns context fields that must be supplied by the browser for a query target. */
+export declare function externalPageContextCriteriaKeys(bindings: ResolvedPageContextBindingDescriptor[], target: ResolvedPageContextBindingDescriptor['target']): string[];
+/** Resolves declared context flows without coupling a target to navigator UI state. */
+export declare function resolvePageContextTargetValues(bindings: ResolvedPageContextBindingDescriptor[], target: ResolvedPageContextBindingDescriptor['target'], sourceValues: PageContextSourceValues, targetNavigatorLevelKey?: string): Record<string, unknown> | undefined;

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

@@ -0,0 +1,27 @@
+export type RecordDetailMode = 'create' | 'edit' | 'view';
+/**
+ * State transitions shared by descriptor-driven record detail surfaces.
+ * Containers own their layout; this controller owns only one record's
+ * lifecycle and deliberately contains no drawer, tab or list concerns.
+ */
+export declare function useRecordDetailController<TRecord extends Record<string, unknown>>(): {
+    record: import("vue").Ref<TRecord | undefined, TRecord | undefined>;
+    draft: import("vue").Ref<TRecord | undefined, TRecord | undefined>;
+    mode: import("vue").Ref<RecordDetailMode, RecordDetailMode>;
+    open: import("vue").Ref<boolean, boolean>;
+    loading: import("vue").Ref<boolean, boolean>;
+    loadFailed: import("vue").Ref<boolean, boolean>;
+    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;
+    resolveLoad: (next: TRecord) => void;
+    failLoad: () => void;
+    finishLoad: () => void;
+    beginCreate: (initial: TRecord) => void;
+    beginEdit: () => boolean;
+    cancelEdit: () => void;
+    applySaved: (next: TRecord) => void;
+    clearDeleted: () => void;
+    close: () => void;
+};

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

@@ -6,7 +6,7 @@
  * directory: an App supplies its startup state, navigation and HTTP factory.
  */
 export { default as PlatformAdminRouteOutlet } from './PlatformAdminOutlet.vue';
-export { isPlatformAdminRoutePage, platformAdminModuleRoutes, platformAdminRouteLayouts, platformAdminRoutePrefixes, platformAdminRoutes, resolvePlatformAdminRoute, } from './platformAdminRoutes';
+export { isPlatformAdminRoutePage, platformAdminDynamicModuleRoutes, platformAdminModuleRoutes, platformAdminRouteLayouts, platformAdminRoutePrefixes, platformAdminRoutes, resolvePlatformAdminRoute, } from './platformAdminRoutes';
 export type { PlatformAdminRoute } from './platformAdminRoutes';
 export { provideCurrentUserContext, useCurrentUserContext } from './currentUserContext';
 export { createBackendHttpClient } from './backendHttp';

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

@@ -11,6 +11,11 @@ export interface PlatformAdminRoute {
 }
 export declare const platformAdminRoutes: PlatformAdminRoute[];
 export declare const platformAdminRoutePrefixes: string[];
+/**
+ * Retains readable legacy menu URLs while delegating their content to the standard module runner.
+ * These are deliberately separate from `platformAdminRoutes`: no business-owned Vue page exists.
+ */
+export declare const platformAdminDynamicModuleRoutes: Record<string, string>;
 export declare const platformAdminModuleRoutes: {
     [k: string]: string;
 };

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

@@ -1,5 +1,5 @@
 import { type RealtimeConnectionState } from '../web-core/index';
-import type { WebBusinessRealtimeEvent, WebCommittedChangeSet, WebUserNotification } from '../web-contracts/index';
+import type { WebBusinessRealtimeEvent, WebBusinessNotification, WebCommittedChangeSet, WebUserNotification } from '../web-contracts/index';
 export declare const appDataChangeDispatcher: import("../web-core/index").DataChangeDispatcher;
 export interface AppRealtimeOptions {
     /** Backend origin supplied by the consuming App at runtime. */
@@ -8,6 +8,7 @@ export interface AppRealtimeOptions {
     token?: string;
     onUnauthorized?: () => void;
     onUserNotification?: (notification: WebUserNotification) => void;
+    onBusinessNotification?: (notification: WebBusinessNotification) => void;
     onStateChange?: (state: RealtimeConnectionState) => void;
 }
 export interface AppRealtimeConnection {

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

@@ -0,0 +1,12 @@
+import type { WebBusinessNotification, WebBusinessNotificationAction } from '../web-contracts/index';
+type __VLS_Props = {
+    notifications: WebBusinessNotification[];
+    executeAction: (notification: WebBusinessNotification, action: WebBusinessNotificationAction) => void | Promise<void>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    dismiss: (notificationId: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDismiss?: ((notificationId: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -7,6 +7,11 @@ type __VLS_Props = {
     context: ModuleContext<CrudRecordListBase>;
     selectedId?: string;
     reloadKey?: number;
+    /**
+     * Descriptor-owned criteria from an upstream navigator selection.
+     * They are forwarded as standard query values rather than filtered in the browser.
+     */
+    externalQueryValues?: Record<string, unknown>;
     keyword?: string;
     emptyDescription?: string;
     loadingTip?: string;
@@ -44,6 +49,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     tagOf: (record: CrudRecordListBase) => string | undefined;
     mutedOf: (record: CrudRecordListBase) => boolean;
     reloadKey: number;
+    externalQueryValues: Record<string, unknown>;
     loadingTip: string;
     fallbackTitle: string;
     subtitleOf: (record: CrudRecordListBase) => string | undefined;