@ximatai/muyun-web-app 0.26.5 → 0.26.7

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

@@ -0,0 +1,43 @@
+/**
+ * The platform owns the browser-to-storage transfer mechanics, while an
+ * application owns the authorization request. A caller may additionally run a
+ * business confirmation step, while standard file-reference fields only bind
+ * the returned fileId during their later record save.
+ * MuYunFileServer owns the multipart transport; this module deliberately has
+ * no knowledge of a particular business record type.
+ */
+export interface FileTransferUploadAccess {
+    /** A short-lived MuYunFileServer multipart upload URL supplied by the business API. */
+    uploadUrl: string;
+    formFieldName?: string;
+}
+export interface FileTransferUploadReceipt {
+    file: File;
+    /** Storage service response after unwrapping the conventional { data } envelope. */
+    payload: unknown;
+    response: unknown;
+}
+export interface FileTransferUploadTask {
+    promise: Promise<FileTransferUploadReceipt>;
+    cancel: () => void;
+}
+/** Browser-visible phases shared by upload controls. */
+export type FileTransferUploadState = 'requesting' | 'uploading' | 'confirming' | 'completed';
+export interface FileTransferUploadLifecycleCallbacks {
+    stateChanged: (state: FileTransferUploadState) => void;
+    progressChanged?: (percent: number) => void;
+    taskCreated?: (task: FileTransferUploadTask) => void;
+    taskFinished?: () => void;
+}
+/**
+ * Runs the common browser upload lifecycle without knowing the business record being edited.
+ *
+ * State is reported through callbacks so the consuming control can update its own reactive item. When supplied,
+ * business confirmation completes before the completed transition; otherwise the raw storage payload is returned.
+ */
+export declare function performBrowserFileTransferUpload(file: File, requestUploadAccess: (file: File) => Promise<FileTransferUploadAccess>, confirmUpload: ((receipt: FileTransferUploadReceipt) => Promise<unknown>) | undefined, callbacks: FileTransferUploadLifecycleCallbacks): Promise<{
+    receipt: FileTransferUploadReceipt;
+    result: unknown;
+}>;
+export declare function createBrowserFileTransferUpload(file: File, access: FileTransferUploadAccess, onProgress?: (percent: number) => void): FileTransferUploadTask;
+export declare function unwrapResponsePayload(response: unknown): unknown;

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

@@ -4,6 +4,11 @@ export { confirmAction } from '../vue-ui-antdv/index';
 export { default as CrudRecordListExplorer } from './CrudRecordListExplorer.vue';
 export { default as DrawerOperationBar } from './DrawerOperationBar.vue';
 export { default as DateTimeText } from './DateTimeText.vue';
+export { default as FileSizeText } from './FileSizeText.vue';
+export { default as FileTransferUploader } from './FileTransferUploader.vue';
+export { default as SingleImageFileReferenceField } from './SingleImageFileReferenceField.vue';
+export { createBrowserFileTransferUpload, unwrapResponsePayload } from './fileTransferUpload';
+export type { FileTransferUploadAccess, FileTransferUploadReceipt, FileTransferUploadTask, } from './fileTransferUpload';
 export { default as EnabledSelect } from './EnabledSelect.vue';
 export { default as ModuleActionButton } from './ModuleActionButton.vue';
 export { default as ManagementWorkspace } from './ManagementWorkspace.vue';
@@ -14,23 +19,29 @@ export { default as RecordDetailDrawer } from './RecordDetailDrawer.vue';
 export type { DrawerPromotion } from './drawerPromotion';
 export { default as RecordExternalChangeNotice } from './RecordExternalChangeNotice.vue';
 export { default as RecordDetailFields } from './RecordDetailFields.vue';
+export { default as RecordDetailExtensionSection } from './RecordDetailExtensionSection.vue';
 export { default as RecordDetailPanel } from './RecordDetailPanel.vue';
+export { default as RecordPanelButton } from './RecordPanelButton.vue';
+export { default as RecordPanelState } from './RecordPanelState.vue';
 export { default as RecordExpandedSubtable } from './RecordExpandedSubtable.vue';
 export { default as UserSessionExpandedSubtable } from './UserSessionExpandedSubtable.vue';
 export { userSessionBrowserTitle, userSessionPresenceDescription, userSessionPresenceTitle, userSessionTerminalTitle, } from './userSessionPresentation';
 export { default as RecordExplorerPanel } from './RecordExplorerPanel.vue';
 export type { RecordExplorerItemDescriptor } from './recordExplorerItemModel';
 export { default as RecordFormFields } from './RecordFormFields.vue';
+export { default as RecordFileReferenceTransfer } from './RecordFileReferenceTransfer.vue';
 export { default as RecordListExplorer } from './RecordListExplorer.vue';
 export { default as RecordMetaSection } from './RecordMetaSection.vue';
 export { default as RecordModeDrawer } from './RecordModeDrawer.vue';
 export { default as RecordPicker } from './RecordPicker.vue';
+export { default as RecordMultiPicker } from './RecordMultiPicker.vue';
 export { default as RecordQueryListPanel } from './RecordQueryListPanel.vue';
 export { default as RecycleBinModeButton } from './RecycleBinModeButton.vue';
 export { useRecycleBinExplorerMode, type RecycleBinExplorerMode, type RecycleBinExplorerModeOptions, } from './useRecycleBinExplorerMode';
 export { default as RecordStatusSwitch } from './RecordStatusSwitch.vue';
 export { default as RecordTreeSelector } from './RecordTreeSelector.vue';
 export { default as RecordStatusTag } from './RecordStatusTag.vue';
+export { default as RecordTagList } from './RecordTagList.vue';
 export { useRecycleBinState } from './recycleBinState';
 export type { RecycleBinStateOptions } from './recycleBinState';
 export { createSoftDeletedConflictErrorHandler, extractSoftDeletedConflict, useSoftDeletedConflictHandler, } from './softDeletedConflictHandler';
@@ -45,14 +56,17 @@ 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, RecordQueryListColumn, RecordQueryListMode } from './RecordQueryListPanel.vue';
+export type { QueryListRecord, RecordQueryListCellComponent, RecordQueryListColumn, RecordQueryListMode, } from './RecordQueryListPanel.vue';
 export type { RecordFormFieldDescriptor, RecordFormFieldFallback, RecordFormFieldPickerConfig, RecordFormFieldState, RecordFormFieldValue, RecordFormRecord, } from './recordFormFieldModel';
 export type { CrudRecordListBase } from './crudRecordListModel';
 export { defaultCrudRecordListMatches, defaultCrudRecordListSubtitle, defaultCrudRecordListTitle, } from './crudRecordListModel';
 export { resolveRecordActions } from './recordActionBarModel';
 export { normalizeRecordDraft } from './recordDraftNormalizer';
+export { acceptedMediaTypes, appendUploadedFileReference, fileReferenceIds, issueFileReferenceUploadAccess, uploadedFileId, } from './fileReferenceTransfer';
 export { resolveRecordDetailDisplayValue } from './recordDetailFieldModel';
 export { formatPlatformDateTime, resolveBrowserTimeZone } from './platformDateTime';
+export { formatPlatformFileSize } from './platformFileSize';
+export type { PlatformFileSizeDisplay, PlatformFileSizeOptions } from './platformFileSize';
 export { providePlatformTimeZoneContext, usePlatformTimeZoneContext } from './platformTimeZoneContext';
 export type { PlatformDateTimeDisplay, PlatformDateTimeOptions, PlatformDateTimePrecision, } from './platformDateTime';
 export { childResourceDefaultFormViewCode, resolveRecordFormFieldNames, resolveRecordFormFieldState, resolveRecordFormFields, } from './recordFormFieldModel';

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

@@ -7,6 +7,10 @@ export interface PlatformErrorFeedbackContext {
 export declare function presentPlatformError(cause: unknown, context?: PlatformErrorFeedbackContext): AppError;
 export declare function presentPlatformMessage(message: string, context?: PlatformErrorFeedbackContext): void;
 export declare function presentPlatformSuccess(message: string, context?: PlatformErrorFeedbackContext): void;
+/** Presents a non-blocking recommendation without changing the requested action. */
+export declare function presentPlatformWarning(message: string): void;
+/** Presents a non-blocking progress update without treating it as an action result. */
+export declare function presentPlatformInfo(message: string): void;
 export type PlatformActionErrorHandler<TContext> = {
     code?: string;
     marker?: string;

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

@@ -0,0 +1,10 @@
+export interface PlatformFileSizeDisplay {
+    text: string;
+    title: string;
+    valid: boolean;
+}
+export interface PlatformFileSizeOptions {
+    emptyText?: string;
+    locale?: string;
+}
+export declare function formatPlatformFileSize(value: number | string | bigint | null | undefined, options?: PlatformFileSizeOptions): PlatformFileSizeDisplay;

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

@@ -10,10 +10,16 @@ export interface RecordActionItem {
     /** Keep the row action visible beside the default row action instead of placing it in “more”. */
     pinned?: boolean;
     disabled?: boolean;
+    /** Explains why an otherwise visible action cannot be used. */
+    disabledReason?: string;
     loading?: boolean;
     primary?: boolean;
     danger?: boolean;
     iconName?: UiIconName;
+    /** Runtime-only authorization source for actions rendered outside their owning module surface. */
+    authorizationContext?: ModuleContext<unknown>;
+    /** Runtime-only record ID used with authorizationContext. */
+    authorizationRecordId?: string;
 }
 export interface ResolvedRecordActionItem extends RecordActionItem {
     key: string;
@@ -23,5 +29,10 @@ export interface ResolvedRecordActionItem extends RecordActionItem {
     disabled: boolean;
     loading: boolean;
 }
-export declare function resolveRecordActions(context: Pick<ModuleContext<unknown>, 'action'>, actions: RecordActionItem[], defaultLoading?: boolean, recordId?: string): ResolvedRecordActionItem[];
+type RecordActionContext = Pick<ModuleContext<unknown>, 'action'> & {
+    runtime?: Pick<ModuleContext<unknown>['runtime'], 'snapshot'>;
+    recordActionsSnapshot?: ModuleContext<unknown>['recordActionsSnapshot'];
+};
+export declare function resolveRecordActions(context: RecordActionContext, actions: RecordActionItem[], defaultLoading?: boolean, recordId?: string): ResolvedRecordActionItem[];
 export declare function mergeRecordActions(baseActions: RecordActionItem[], extraActions: RecordActionItem[]): RecordActionItem[];
+export {};

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

@@ -1,12 +1,17 @@
-import type { Option, OptionValueList, ResolvedOptionFieldDescriptor, ResolvedModuleUiDescriptor, ResolvedViewFieldDescriptor, ViewFieldDefinition } from '../web-contracts/index';
+import type { Option, OptionValueList, ResolvedReferenceFieldDescriptor, BooleanStatusPresentation, ResolvedOptionFieldDescriptor, ResolvedFileReferenceFieldDescriptor, ResolvedModuleUiDescriptor, ResolvedViewFieldDescriptor, FieldValuePresentation, FormGroupDescriptor, UiFormula, ViewFieldDefinition } from '../web-contracts/index';
 import type { ModuleContext } from '../web-core/index';
 import type { PickerConstraint, RecordPickerRecord } from './recordPickerConstraints';
 export type RecordFormFieldDescriptor = (ViewFieldDefinition | ResolvedViewFieldDescriptor) & {
     option?: ResolvedOptionFieldDescriptor;
+    reference?: ResolvedReferenceFieldDescriptor;
+    fileReference?: ResolvedFileReferenceFieldDescriptor;
+    formGroup?: FormGroupDescriptor;
 };
 export type RecordFormRecord = Record<string, unknown>;
-export type RecordFormFieldValue = string | number | boolean | OptionValueList | undefined;
-export type RecordFormFieldControlType = 'input' | 'select' | 'enabledStatus' | 'switch' | 'recordPicker';
+export type RecordFormFieldValue = string | number | boolean | OptionValueList | string[] | undefined;
+/** A business boolean does not inherit the lifecycle field's implicit enabled default. */
+export type RecordBooleanStatusValue = boolean | undefined;
+export type RecordFormFieldControlType = 'input' | 'textarea' | 'colorPicker' | 'select' | 'enabledStatus' | 'booleanStatus' | 'switch' | 'recordPicker' | 'recordMultiPicker' | 'fileTransfer' | 'imageFileTransfer';
 export interface RecordFormFieldFallback {
     label: string;
     required?: boolean;
@@ -14,6 +19,7 @@ export interface RecordFormFieldFallback {
     visible?: boolean;
     controlType?: RecordFormFieldControlType;
     placeholder?: string;
+    disabledHint?: string;
     options?: Option[];
     optionSelectionMode?: 'SINGLE' | 'MULTIPLE';
 }
@@ -35,12 +41,19 @@ export interface RecordFormFieldState {
     readOnly: boolean;
     visible: boolean;
     controlType: RecordFormFieldControlType;
+    columnSpan: number;
     hasOption: boolean;
     optionSelectionMode?: 'SINGLE' | 'MULTIPLE';
     optionTitleField?: string;
+    referenceTitleField?: string;
+    fileReference?: ResolvedFileReferenceFieldDescriptor;
     pickerConfig?: RecordFormFieldPickerConfig;
+    booleanStatus?: BooleanStatusPresentation;
+    valuePresentation?: FieldValuePresentation;
+    disabledHint?: string;
     placeholder?: string;
     options?: Option[];
+    formGroup?: FormGroupDescriptor;
 }
 export interface ResolveRecordFormFieldNamesOptions {
     explicitOrder?: string[];
@@ -48,10 +61,18 @@ export interface ResolveRecordFormFieldNamesOptions {
 }
 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 childResourceDefaultFormViewCode(resource: string): string;
 export declare function resolveRecordFormFieldState(fieldName: string, options?: {
     fields?: Map<string, RecordFormFieldDescriptor>;
     fallback?: Record<string, RecordFormFieldFallback>;
     pickerConfigs?: Record<string, RecordFormFieldPickerConfig>;
     placeholderOf?: (fieldName: string, field: RecordFormFieldState) => string | undefined;
+    record?: RecordFormRecord;
 }): RecordFormFieldState;
+export declare function evaluateUiFormula(formula: UiFormula, record: RecordFormRecord): boolean;
+/**
+ * Preserves an absent business value as unknown instead of treating it as true.
+ * `enabledStatus` deliberately retains its separate lifecycle default semantics.
+ */
+export declare function resolveRecordBooleanStatusValue(value: unknown): RecordBooleanStatusValue;

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

@@ -1,7 +1,7 @@
 import type { ModuleContext, StaticModuleTreeClient } from '../web-core/index';
 export interface ScopedTreeModuleContextOptions {
     scopeFieldName: string;
-    scopeValue: string | undefined;
+    scopeValue: string | undefined | (() => string | undefined);
     treePath: string;
     sortPath?: string;
     treeQueryParam?: string;

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

@@ -60,7 +60,7 @@ export declare function useFlatCrudManagementState<TRecord extends StaticCrudRec
     startCreate: () => void;
     startEdit: () => void;
     cancelEdit: () => void;
-    save: () => Promise<void>;
+    save: () => Promise<boolean>;
     toggleEnabled: () => Promise<void>;
     removeSelected: () => Promise<void>;
 };

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

@@ -5,28 +5,36 @@ type __VLS_Props = {
     loading?: boolean;
     error?: string;
     activeTabKey?: string;
+    lockedTabKeys?: string[];
     realtimeStatus?: WorkbenchRealtimeStatus;
+    themeAppearance?: 'light' | 'dark';
 };
-declare var __VLS_66: {
+declare var __VLS_88: {
     activeTab: MenuTab;
     target: MenuNavigationTarget | undefined;
     pageDescriptor: PageDescriptor | undefined;
 };
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_66) => any;
+    default?: (props: typeof __VLS_88) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    closeTabs: (keys: string[]) => any;
     selectMenu: (menu: MenuRecord, target: MenuNavigationTarget) => any;
     invalidMenu: (menu: MenuRecord) => any;
     changeTab: (key: string) => any;
     closeTab: (key: string) => any;
+    toggleTabLock: (key: string) => any;
+    reorderTabs: (keys: string[]) => any;
     "update:activeTabKey": (key: string) => any;
     userCommand: (key: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCloseTabs?: ((keys: string[]) => any) | undefined;
     onSelectMenu?: ((menu: MenuRecord, target: MenuNavigationTarget) => any) | undefined;
     onInvalidMenu?: ((menu: MenuRecord) => any) | undefined;
     onChangeTab?: ((key: string) => any) | undefined;
     onCloseTab?: ((key: string) => any) | undefined;
+    onToggleTabLock?: ((key: string) => any) | undefined;
+    onReorderTabs?: ((keys: string[]) => any) | undefined;
     "onUpdate:activeTabKey"?: ((key: string) => any) | undefined;
     onUserCommand?: ((key: string) => any) | undefined;
 }>, {
@@ -35,6 +43,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     realtimeStatus: WorkbenchRealtimeStatus;
     startup: WorkbenchStartupState;
     activeTabKey: string;
+    lockedTabKeys: string[];
+    themeAppearance: "light" | "dark";
 }, {}, {}, {}, 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-workbench/WorkbenchBrandControl.vue.d.ts

@@ -0,0 +1,41 @@
+interface CompactMenuAnchor {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+type __VLS_Props = {
+    presentation: 'compact' | 'expanded';
+    compactOpen?: boolean;
+    tenantLabel?: string;
+    logoSrc?: string;
+    showTitleArea?: boolean;
+    brandTitle?: string;
+    brandSubtitle?: string;
+    expandedMenuDepth?: 1 | 2 | 3;
+    presentationToggleVisible?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    openCompactMenu: (source: "click" | "focus" | "pointer", anchor: CompactMenuAnchor) => any;
+    scheduleCompactMenuClose: () => any;
+    closeCompactMenu: () => any;
+    changePresentation: (presentation: "compact" | "expanded") => any;
+    changeExpandedMenuDepth: (depth: 1 | 2 | 3) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onOpenCompactMenu?: ((source: "click" | "focus" | "pointer", anchor: CompactMenuAnchor) => any) | undefined;
+    onScheduleCompactMenuClose?: (() => any) | undefined;
+    onCloseCompactMenu?: (() => any) | undefined;
+    onChangePresentation?: ((presentation: "compact" | "expanded") => any) | undefined;
+    onChangeExpandedMenuDepth?: ((depth: 1 | 2 | 3) => any) | undefined;
+}>, {
+    compactOpen: boolean;
+    tenantLabel: string;
+    logoSrc: string;
+    showTitleArea: boolean;
+    brandTitle: string;
+    brandSubtitle: string;
+    expandedMenuDepth: 1 | 2 | 3;
+    presentationToggleVisible: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -4,20 +4,58 @@ type __VLS_Props = {
     menus: MenuTreeNode[];
     selectedMenuId?: string;
     tenantLabel?: string;
+    logoSrc?: string;
+    showTitleArea?: boolean;
+    brandTitle?: string;
+    brandSubtitle?: string;
     searchPlaceholder?: string;
     realtimeStatus?: WorkbenchRealtimeStatus;
+    presentation?: 'compact' | 'expanded';
+    expandedMenuDepth?: 1 | 2 | 3;
+    compactOpen?: boolean;
+    compactTop?: number;
+    compactAnchor?: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    changePresentation: (presentation: "compact" | "expanded") => any;
+    changeExpandedMenuDepth: (depth: 1 | 2 | 3) => any;
     selectMenu: (menu: MenuRecord, target: MenuNavigationTarget) => any;
     invalidMenu: (menu: MenuRecord) => any;
+    compactMenuEnter: () => any;
+    compactMenuLeave: () => any;
+    compactMenuClose: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChangePresentation?: ((presentation: "compact" | "expanded") => any) | undefined;
+    onChangeExpandedMenuDepth?: ((depth: 1 | 2 | 3) => any) | undefined;
     onSelectMenu?: ((menu: MenuRecord, target: MenuNavigationTarget) => any) | undefined;
     onInvalidMenu?: ((menu: MenuRecord) => any) | undefined;
+    onCompactMenuEnter?: (() => any) | undefined;
+    onCompactMenuLeave?: (() => any) | undefined;
+    onCompactMenuClose?: (() => any) | undefined;
 }>, {
-    selectedMenuId: string;
+    presentation: "compact" | "expanded";
+    compactOpen: boolean;
     tenantLabel: string;
+    logoSrc: string;
+    showTitleArea: boolean;
+    brandTitle: string;
+    brandSubtitle: string;
+    expandedMenuDepth: 1 | 2 | 3;
+    selectedMenuId: string;
     searchPlaceholder: string;
     realtimeStatus: WorkbenchRealtimeStatus;
+    compactTop: number;
+    compactAnchor: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -3,6 +3,8 @@ import type { WorkbenchMenuNode } from './menuTreeModel';
 type __VLS_Props = {
     node: WorkbenchMenuNode;
     level?: number;
+    selectedMenuId?: string;
+    selectedPathIds?: string[];
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     selectMenu: (menu: MenuRecord, target: MenuNavigationTarget) => any;

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

@@ -0,0 +1,19 @@
+import type { WorkbenchMenuNode } from './menuTreeModel';
+type __VLS_Props = {
+    node: WorkbenchMenuNode;
+    mode: 'inline' | 'flyout';
+    selected?: boolean;
+    selectedPath?: boolean;
+    active?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (node: WorkbenchMenuNode) => any;
+    openChildren: (node: WorkbenchMenuNode, event: MouseEvent, anchor: HTMLElement) => any;
+    toggleChildren: (node: WorkbenchMenuNode, anchor: HTMLElement) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((node: WorkbenchMenuNode) => any) | undefined;
+    onOpenChildren?: ((node: WorkbenchMenuNode, event: MouseEvent, anchor: HTMLElement) => any) | undefined;
+    onToggleChildren?: ((node: WorkbenchMenuNode, anchor: HTMLElement) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -0,0 +1,7 @@
+import type { BusinessRoutePageDescriptor } from '../web-contracts/index';
+type __VLS_Props = {
+    descriptor: BusinessRoutePageDescriptor;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -1,8 +1,15 @@
 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 { provideWorkbenchNavigation, useWorkbenchNavigation } from './workbenchNavigation';
 export type { WorkbenchNavigation, WorkbenchPageOpenResult } from './workbenchNavigation';
+export { configureWorkspaceViewContributions, createWorkspaceViewDescriptor, createWorkspaceViewRegistry, dismissWorkspaceViewDescriptor, resolveWorkspaceView, } from './workspaceViews';
+export { provideWorkspaceViewHost, useWorkspaceViewHost } from './workspaceViewHost';
+export { defineWorkspaceView } from './workspaceViewContract';
+export type { ResolvedWorkspaceView, WorkspaceViewRegistry } from './workspaceViews';
+export type { WorkspaceViewDefinition, WorkspaceViewInput, WorkspaceViewPresentation, WorkspaceDrawerProfile, } from './workspaceViewContract';
+export type { WorkspaceViewHost } from './workspaceViewHost';
 export { createMenuTab, findFirstNavigationMenu, getMenuNavigationTarget, isTabMenuTarget, isWindowMenuTarget, pageDescriptorFromUrl, pageDescriptorToUrl, resolvePageDescriptor, tabKeyOf, tryPageDescriptorFromUrl, } from './menuNavigation';
 export type { PageDescriptorResolveOptions, PageDescriptorUrlParseOptions } from './menuNavigation';
 export { buildWorkbenchMegaMenuModel, createWorkbenchMenuNodes, filterWorkbenchMenuNodes, findWorkbenchMenuNodeById, findWorkbenchMenuPath, firstDeepRootIdOf, } from './menuTreeModel';

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

@@ -0,0 +1,10 @@
+export interface MenuHoverClickIntent {
+    markHoverActivation(menuId: string): void;
+    consumeImmediateClick(menuId: string): boolean;
+    clear(): void;
+}
+/**
+ * Treats the hover activation immediately preceding a click as the same open intent.
+ * A later click remains a deliberate toggle and may close the active menu.
+ */
+export declare function createMenuHoverClickIntent(gracePeriod: number, now?: () => number): MenuHoverClickIntent;

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

@@ -0,0 +1,11 @@
+export interface MenuPointerPosition {
+    x: number;
+    y: number;
+}
+export interface MenuPanelEdge {
+    left: number;
+    top: number;
+    bottom: number;
+}
+/** Keeps the active menu item stable while the pointer crosses towards its flyout panel. */
+export declare function isPointerHeadingToMenuPanel(pointer: MenuPointerPosition, origin: MenuPointerPosition, panel: MenuPanelEdge): boolean;

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

@@ -0,0 +1,4 @@
+export declare function compactMenuTopOf(topbarBottom: number, workbenchTop: number): number;
+export declare function floatingPanelTopOf(anchorViewportTop: number, panelHeight: number, viewportHeight: number, shellViewportTop: number, margin?: number): number;
+export type WorkbenchMenuPresentation = 'compact' | 'expanded';
+export declare function effectiveWorkbenchMenuPresentation(preferredPresentation: WorkbenchMenuPresentation, narrowViewport: boolean): WorkbenchMenuPresentation;

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

@@ -0,0 +1,20 @@
+import type { Component } from 'vue';
+import type { PageLayoutMode, RouteQueryValue } from '../web-contracts/index';
+export type WorkspaceViewInput = object;
+export type WorkspaceViewPresentation = 'drawer' | 'tab';
+export type WorkspaceDrawerProfile = 'detail' | 'wide-work';
+/** Stable, URL-restorable declaration shared by all workbench view hosts. */
+export interface WorkspaceViewDefinition<TInput extends WorkspaceViewInput> {
+    type: string;
+    route: string;
+    moduleAlias: string;
+    component: Component;
+    layout?: PageLayoutMode;
+    drawerProfile?: WorkspaceDrawerProfile;
+    routeTitle?: string;
+    titleOf(input: TInput): string;
+    parentRouteQueryOf?(input: TInput): Record<string, RouteQueryValue>;
+    parse(query: Record<string, RouteQueryValue>): TInput | undefined;
+    presentations: readonly WorkspaceViewPresentation[];
+}
+export declare function defineWorkspaceView<TInput extends WorkspaceViewInput>(definition: WorkspaceViewDefinition<TInput>): WorkspaceViewDefinition<TInput>;

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

@@ -0,0 +1,8 @@
+import type { WorkspaceViewPresentation } from './workspaceViewContract';
+export interface WorkspaceViewHost {
+    presentation: WorkspaceViewPresentation;
+    setTitle(title: string): void;
+    dismiss(): void;
+}
+export declare function provideWorkspaceViewHost(host: WorkspaceViewHost): void;
+export declare function useWorkspaceViewHost(): WorkspaceViewHost | undefined;

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

@@ -0,0 +1,21 @@
+import type { BusinessRoutePageDescriptor } from '../web-contracts/index';
+import type { WorkspaceViewDefinition, WorkspaceViewInput, WorkspaceViewPresentation } from './workspaceViewContract';
+export { defineWorkspaceView, type WorkspaceDrawerProfile, type WorkspaceViewDefinition, type WorkspaceViewInput, type WorkspaceViewPresentation, } from './workspaceViewContract';
+export interface ResolvedWorkspaceView {
+    view: WorkspaceViewDefinition<WorkspaceViewInput>;
+    input: WorkspaceViewInput;
+    presentation: WorkspaceViewPresentation;
+}
+export interface WorkspaceViewRegistry {
+    definitions: readonly WorkspaceViewDefinition<WorkspaceViewInput>[];
+    resolve(descriptor: BusinessRoutePageDescriptor): ResolvedWorkspaceView | undefined;
+}
+/**
+ * Replaces one application contribution set.  Owners keep their registrations
+ * isolated while every workbench host resolves one shared global view catalog.
+ */
+export declare function configureWorkspaceViewContributions(owner: string, definitions: readonly WorkspaceViewDefinition<WorkspaceViewInput>[]): void;
+export declare function createWorkspaceViewRegistry(definitions: readonly WorkspaceViewDefinition<WorkspaceViewInput>[]): WorkspaceViewRegistry;
+export declare function createWorkspaceViewDescriptor<TInput extends WorkspaceViewInput>(view: WorkspaceViewDefinition<TInput>, input: TInput, presentation?: WorkspaceViewPresentation, title?: string): BusinessRoutePageDescriptor;
+export declare function dismissWorkspaceViewDescriptor(descriptor: BusinessRoutePageDescriptor, view: WorkspaceViewDefinition<WorkspaceViewInput>): BusinessRoutePageDescriptor;
+export declare function resolveWorkspaceView(descriptor: BusinessRoutePageDescriptor): ResolvedWorkspaceView | undefined;

package/dist/types/views/applicationManagementState.d.ts

@@ -57,7 +57,7 @@ export declare function createApplicationManagementState(applicationContext: Mod
     startCreate: () => void;
     startEdit: () => void;
     cancelEdit: () => void;
-    save: () => Promise<void>;
+    save: () => Promise<boolean>;
     toggleEnabled: () => Promise<void>;
     removeSelected: () => Promise<void>;
 };

package/dist/types/views/employeeDetailWorkspaceView.d.ts

@@ -1,4 +1,4 @@
 export interface EmployeeDetailWorkspaceViewInput {
     recordId: string;
 }
-export declare const employeeDetailWorkspaceView: import("../platform-admin-runtime/workspaceViewContract").WorkspaceViewDefinition<EmployeeDetailWorkspaceViewInput>;
+export declare const employeeDetailWorkspaceView: import("../platform-workbench/workspaceViewContract.ts").WorkspaceViewDefinition<EmployeeDetailWorkspaceViewInput>;

package/dist/types/views/fieldSpecManagementState.d.ts

@@ -73,7 +73,7 @@ export declare function createFieldSpecManagementState(fieldSpecContext: ModuleC
     startCreate: () => void;
     startEdit: () => void;
     cancelEdit: () => void;
-    save: () => Promise<void>;
+    save: () => Promise<boolean>;
     toggleEnabled: () => Promise<void>;
     removeSelected: () => Promise<void>;
 };

package/dist/types/views/fieldUiControlManagementState.d.ts

@@ -69,7 +69,7 @@ export declare function createFieldUiControlManagementState(fieldUiControlContex
     startCreate: () => void;
     startEdit: () => void;
     cancelEdit: () => void;
-    save: () => Promise<void>;
+    save: () => Promise<boolean>;
     toggleEnabled: () => Promise<void>;
     removeSelected: () => Promise<void>;
 };

package/dist/types/views/metadataOrchestrationWorkspaceView.d.ts

@@ -3,4 +3,4 @@ export interface MetadataOrchestrationWorkspaceViewInput {
     moduleTitle?: string;
 }
 /** A tab-scoped metadata workbench for one dynamic module. */
-export declare const metadataOrchestrationWorkspaceView: import("../platform-admin-runtime/workspaceViewContract").WorkspaceViewDefinition<MetadataOrchestrationWorkspaceViewInput>;
+export declare const metadataOrchestrationWorkspaceView: import("../platform-workbench/workspaceViewContract.ts").WorkspaceViewDefinition<MetadataOrchestrationWorkspaceViewInput>;

package/dist/types/views/moduleActionManagementWorkspaceView.d.ts

@@ -4,4 +4,4 @@ export interface ModuleActionManagementWorkspaceViewInput {
     moduleKind?: 'static' | 'dynamic';
 }
 /** A tab-scoped action directory for exactly one module. */
-export declare const moduleActionManagementWorkspaceView: import("../platform-admin-runtime/workspaceViewContract").WorkspaceViewDefinition<ModuleActionManagementWorkspaceViewInput>;
+export declare const moduleActionManagementWorkspaceView: import("../platform-workbench/workspaceViewContract.ts").WorkspaceViewDefinition<ModuleActionManagementWorkspaceViewInput>;

package/dist/types/views/roleAuthorizationWorkspaceView.d.ts

@@ -2,4 +2,4 @@
 export interface RoleAuthorizationWorkspaceViewInput {
     roleId: string;
 }
-export declare const roleAuthorizationWorkspaceView: import("../platform-admin-runtime/workspaceViewContract").WorkspaceViewDefinition<RoleAuthorizationWorkspaceViewInput>;
+export declare const roleAuthorizationWorkspaceView: import("../platform-workbench/workspaceViewContract.ts").WorkspaceViewDefinition<RoleAuthorizationWorkspaceViewInput>;

package/dist/types/views/roleDetailWorkspaceView.d.ts

@@ -5,4 +5,4 @@ export interface RoleDetailWorkspaceViewInput {
     /** Platform-owned roles deliberately have no scope id. */
     scopeId?: string;
 }
-export declare const roleDetailWorkspaceView: import("../platform-admin-runtime/workspaceViewContract").WorkspaceViewDefinition<RoleDetailWorkspaceViewInput>;
+export declare const roleDetailWorkspaceView: import("../platform-workbench/workspaceViewContract.ts").WorkspaceViewDefinition<RoleDetailWorkspaceViewInput>;

package/dist/types/views/systemUserDetailWorkspaceView.d.ts

@@ -2,4 +2,4 @@ export interface SystemUserDetailWorkspaceViewInput {
     recordId: string;
 }
 /** A system account detail has a stable identity and can be resumed independently. */
-export declare const systemUserDetailWorkspaceView: import("../platform-admin-runtime/workspaceViewContract").WorkspaceViewDefinition<SystemUserDetailWorkspaceViewInput>;
+export declare const systemUserDetailWorkspaceView: import("../platform-workbench/workspaceViewContract.ts").WorkspaceViewDefinition<SystemUserDetailWorkspaceViewInput>;