@ximatai/muyun-web-app 0.26.6 → 0.26.7

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,16 @@ 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 only currently visible tab menus, rebuilding their descriptors from the active menu scheme. */
+export declare function restoreLockedMenuTabs(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, {
+    userCommand: (key: string) => any;
+    navigate: (navigation: AppWorkbenchNavigation) => any;
+    "update:startup": (value: WorkbenchStartupState) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onUserCommand?: ((key: string) => any) | undefined;
+    onNavigate?: ((navigation: AppWorkbenchNavigation) => 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,33 @@
  *
  * 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, restoreLockedMenuTabs, 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 type { ModuleListEnhancement, ModuleDetailEnhancement, ModulePageActionContext, ModulePageActionContribution, ModulePageActionStateContext, ModulePageBatchActionContext, ModulePageBatchActionContribution, ModulePageColumnContribution, 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, } 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 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/index.d.ts

@@ -5,4 +5,4 @@ export { configureModulePageEnhancements, createModulePageEnhancementRegistry, m
 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, ModulePageDetailSection, ModulePageDetailSectionContext, ModulePageDrawer, ModulePageDrawerContext, ModulePageEnhancement, ModulePageEnhancementRegistry, ModulePageEnhancementTarget, ModulePageRecordActionContext, ModulePageRecordActionContribution, ModulePageScopeContext, ModulePageWorkspaceView, ModulePageWorkspaceViewInput, } from './modulePageEnhancements';

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

@@ -38,12 +38,16 @@ export interface ModuleDetailEnhancement {
 }
 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 {
@@ -88,6 +92,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 +101,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/platform-components/FileTransferUploader.vue.d.ts

@@ -1,7 +1,9 @@
 import { type FileTransferUploadAccess, type FileTransferUploadReceipt } from './fileTransferUpload';
 type __VLS_Props = {
     /** Business API callback: authorize this exact file and return a short-lived upload target. */
-    requestUploadAccess: (file: File) => Promise<FileTransferUploadAccess>;
+    requestUploadAccess?: (file: File) => Promise<FileTransferUploadAccess>;
+    /** Storage-specific transport; ordinary FileServer fields continue to use upload access tickets. */
+    uploadFile?: (file: File) => Promise<FileTransferUploadReceipt>;
     /** Optional business callback after upload. Standard file-reference fields leave this undefined. */
     confirmUpload?: (receipt: FileTransferUploadReceipt) => Promise<unknown>;
     accept?: string;
@@ -14,7 +16,16 @@ type __VLS_Props = {
     existingFileCount?: number;
     autoUpload?: boolean;
     uploadText?: string;
+    presentation?: 'dropzone' | 'button';
+    uploadButtonType?: 'default' | 'primary' | 'dashed' | 'link' | 'text';
+    showCompletedItems?: boolean;
+    /** Non-blocking, browser-side guidance evaluated after file selection and before transfer. */
+    uploadAdvisory?: (file: File) => string | undefined | Promise<string | undefined>;
+    /** Business-owned preflight validation; returning a message rejects the selected file before transfer. */
+    uploadValidation?: (file: File) => string | undefined | Promise<string | undefined>;
     disabledHint?: string;
+    /** Persistent guidance displayed in the dropzone before a file is selected. */
+    dropzoneHint?: string;
     completionHint?: string;
     /** Completed items may be retained when the surrounding form owns deletion semantics. */
     allowCompletedRemoval?: boolean;
@@ -33,6 +44,9 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
 }>, {
     disabled: boolean;
     multiple: boolean;
+    presentation: "dropzone" | "button";
+    requestUploadAccess: (file: File) => Promise<FileTransferUploadAccess>;
+    uploadFile: (file: File) => Promise<FileTransferUploadReceipt>;
     confirmUpload: (receipt: FileTransferUploadReceipt) => Promise<unknown>;
     accept: string;
     allowedMediaTypes: string[];
@@ -41,7 +55,12 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     existingFileCount: number;
     autoUpload: boolean;
     uploadText: string;
+    uploadButtonType: "default" | "primary" | "dashed" | "link" | "text";
+    showCompletedItems: boolean;
+    uploadAdvisory: (file: File) => string | undefined | Promise<string | undefined>;
+    uploadValidation: (file: File) => string | undefined | Promise<string | undefined>;
     disabledHint: string;
+    dropzoneHint: string;
     completionHint: string;
     allowCompletedRemoval: boolean;
     releasedCompletedFileIds: readonly string[];

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

@@ -0,0 +1,30 @@
+import { type UiIconName } from '../vue-ui-antdv/index';
+type __VLS_Props = {
+    title: string;
+    subtitle?: string;
+    titleActionIcon?: UiIconName;
+    titleActionTitle?: string;
+};
+declare var __VLS_9: {}, __VLS_11: {};
+type __VLS_Slots = {} & {
+    status?: (props: typeof __VLS_9) => any;
+} & {
+    actions?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    titleAction: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onTitleAction?: (() => any) | undefined;
+}>, {
+    subtitle: string;
+    titleActionIcon: UiIconName;
+    titleActionTitle: string;
+}, {}, {}, {}, 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/platform-components/RecordDetailLayout.vue.d.ts

@@ -8,19 +8,21 @@ type __VLS_Props = {
     /** Internal composition surface selected by the hosting platform component. */
     surface?: 'workspace' | 'drawer';
 };
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {}, __VLS_17: {};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {}, __VLS_11: {}, __VLS_19: {};
 type __VLS_Slots = {} & {
-    status?: (props: typeof __VLS_1) => any;
+    header?: (props: typeof __VLS_1) => any;
 } & {
-    'title-actions'?: (props: typeof __VLS_3) => any;
+    status?: (props: typeof __VLS_3) => any;
 } & {
-    actions?: (props: typeof __VLS_5) => any;
+    'title-actions'?: (props: typeof __VLS_5) => any;
 } & {
-    default?: (props: typeof __VLS_7) => any;
+    actions?: (props: typeof __VLS_7) => any;
 } & {
     default?: (props: typeof __VLS_9) => any;
 } & {
-    operation?: (props: typeof __VLS_17) => any;
+    default?: (props: typeof __VLS_11) => any;
+} & {
+    operation?: (props: typeof __VLS_19) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     subtitle: string;

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

@@ -2,15 +2,15 @@ type __VLS_Props = {
     title: string;
     subtitle?: string;
 };
-declare var __VLS_9: {}, __VLS_12: {}, __VLS_14: {}, __VLS_17: {};
+declare var __VLS_16: {}, __VLS_19: {}, __VLS_21: {}, __VLS_24: {};
 type __VLS_Slots = {} & {
-    status?: (props: typeof __VLS_9) => any;
+    status?: (props: typeof __VLS_16) => any;
 } & {
-    actions?: (props: typeof __VLS_12) => any;
+    actions?: (props: typeof __VLS_19) => any;
 } & {
-    default?: (props: typeof __VLS_14) => any;
+    default?: (props: typeof __VLS_21) => any;
 } & {
-    operation?: (props: typeof __VLS_17) => any;
+    operation?: (props: typeof __VLS_24) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     subtitle: string;

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

@@ -5,17 +5,17 @@ type __VLS_Props = {
     searchPlaceholder?: string;
     searchable?: boolean;
 };
-declare var __VLS_9: {}, __VLS_18: {}, __VLS_34: {}, __VLS_36: {}, __VLS_38: {};
+declare var __VLS_10: {}, __VLS_20: {}, __VLS_36: {}, __VLS_38: {}, __VLS_40: {};
 type __VLS_Slots = {} & {
-    'title-extra'?: (props: typeof __VLS_9) => any;
+    'title-extra'?: (props: typeof __VLS_10) => any;
 } & {
-    actions?: (props: typeof __VLS_18) => any;
+    actions?: (props: typeof __VLS_20) => any;
 } & {
-    default?: (props: typeof __VLS_34) => any;
+    default?: (props: typeof __VLS_36) => any;
 } & {
-    footer?: (props: typeof __VLS_36) => any;
+    footer?: (props: typeof __VLS_38) => any;
 } & {
-    editor?: (props: typeof __VLS_38) => any;
+    editor?: (props: typeof __VLS_40) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     refresh: () => any;

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

@@ -9,6 +9,16 @@ type __VLS_Props = {
     formSessionKey?: string | number;
     disabled?: boolean;
     disabledHint?: string;
+    dropzoneHint?: string;
+    showBoundFiles?: boolean;
+    uploaderPresentation?: 'dropzone' | 'button';
+    uploadText?: string;
+    uploadButtonType?: 'default' | 'primary' | 'dashed' | 'link' | 'text';
+    showCompletedUploadItems?: boolean;
+    /** The enclosing field has already rendered the bound file and needs the uploader slot immediately reusable. */
+    releaseCompletedUploadOnBind?: boolean;
+    uploadAdvisory?: (file: File) => string | undefined | Promise<string | undefined>;
+    uploadValidation?: (file: File) => string | undefined | Promise<string | undefined>;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:value": (value: string | string[] | undefined) => any;

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

@@ -13,6 +13,8 @@ type __VLS_Props = {
     disabled?: boolean;
     disabledOf?: (fieldName: string, field: RecordFormFieldState) => boolean;
     placeholderOf?: (fieldName: string, field: RecordFormFieldState) => string | undefined;
+    imageUploadHintOf?: (fieldName: string, field: RecordFormFieldState) => string | undefined;
+    imageUploadAdvisoryOf?: (fieldName: string, field: RecordFormFieldState) => ((file: File) => string | undefined | Promise<string | undefined>) | undefined;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:field": (fieldName: string, value: RecordFormFieldValue) => any;
@@ -22,14 +24,16 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     disabled: boolean;
     fieldNames: string[];
     fields: Map<string, RecordFormFieldDescriptor>;
+    formSessionKey: string | number;
     excludeFieldNames: string[];
     fallback: Record<string, RecordFormFieldFallback>;
     pickerConfigs: Record<string, RecordFormFieldPickerConfig>;
-    formSessionKey: string | number;
     optionContext: ModuleContext<unknown>;
     fileTransferContext: ModuleContext<unknown>;
     disabledOf: (fieldName: string, field: RecordFormFieldState) => boolean;
     placeholderOf: (fieldName: string, field: RecordFormFieldState) => string | undefined;
+    imageUploadHintOf: (fieldName: string, field: RecordFormFieldState) => string | undefined;
+    imageUploadAdvisoryOf: (fieldName: string, field: RecordFormFieldState) => ((file: File) => string | undefined | Promise<string | undefined>) | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -0,0 +1,23 @@
+import type { ModuleContext } from '../web-core/index';
+import type { ResolvedFileReferenceFieldDescriptor } from '../web-contracts/index';
+type __VLS_Props = {
+    label: string;
+    required?: boolean;
+    value: unknown;
+    record: Record<string, unknown>;
+    context: ModuleContext<unknown>;
+    definition: ResolvedFileReferenceFieldDescriptor;
+    uploadHint?: string;
+    uploadAdvisory?: (file: File) => string | undefined | Promise<string | undefined>;
+    uploadValidation?: (file: File) => string | undefined | Promise<string | undefined>;
+    formSessionKey?: string | number;
+    disabled?: boolean;
+    disabledHint?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:value": (value: string | undefined) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:value"?: ((value: string | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -3,6 +3,14 @@ import type { ResolvedFileReferenceFieldDescriptor } from '../web-contracts/inde
 import type { FileTransferUploadAccess } from './fileTransferUpload';
 /** Issues the module-owned short-lived upload ticket for a declared file-reference field. */
 export declare function issueFileReferenceUploadAccess(http: HttpClient, moduleAlias: string, definition: ResolvedFileReferenceFieldDescriptor, draft: Record<string, unknown>, file: File, intent: FileReferenceUploadIntent): Promise<FileTransferUploadAccess>;
+/** Uploads one DATABASE_INLINE field through the same authenticated platform HTTP client. */
+export declare function uploadInlineFileReference(http: HttpClient, moduleAlias: string, definition: ResolvedFileReferenceFieldDescriptor, draft: Record<string, unknown>, file: File, intent: FileReferenceUploadIntent): Promise<{
+    file: File;
+    payload: unknown;
+    response: unknown;
+}>;
+/** Resolves a policy-authorized preview or download target without coupling a field to either storage provider. */
+export declare function issueFileReferenceAccess(http: HttpClient, moduleAlias: string, definition: ResolvedFileReferenceFieldDescriptor, draft: Record<string, unknown>, fileId: string, operation: 'preview' | 'download'): Promise<string>;
 /** A policy-visible upload fact, derived from the field cardinality and its current binding. */
 export type FileReferenceUploadIntent = 'CREATE' | 'APPEND' | 'REPLACE';
 export declare function fileReferenceUploadIntent(value: unknown, definition: ResolvedFileReferenceFieldDescriptor): FileReferenceUploadIntent;

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

@@ -6,6 +6,7 @@ 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';

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

@@ -7,6 +7,8 @@ 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> = {

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;

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

@@ -1,16 +1,17 @@
-import type { Option, OptionValueList, ResolvedReferenceFieldDescriptor, BooleanStatusPresentation, ResolvedOptionFieldDescriptor, ResolvedFileReferenceFieldDescriptor, ResolvedModuleUiDescriptor, ResolvedViewFieldDescriptor, FieldValuePresentation, UiFormula, 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 | 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';
+export type RecordFormFieldControlType = 'input' | 'textarea' | 'colorPicker' | 'select' | 'enabledStatus' | 'booleanStatus' | 'switch' | 'recordPicker' | 'recordMultiPicker' | 'fileTransfer' | 'imageFileTransfer';
 export interface RecordFormFieldFallback {
     label: string;
     required?: boolean;
@@ -52,6 +53,7 @@ export interface RecordFormFieldState {
     disabledHint?: string;
     placeholder?: string;
     options?: Option[];
+    formGroup?: FormGroupDescriptor;
 }
 export interface ResolveRecordFormFieldNamesOptions {
     explicitOrder?: string[];
@@ -59,6 +61,7 @@ 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>;

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>;
 };