@ximatai/muyun-web-app 0.26.6 → 0.26.8

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

@@ -69,6 +69,37 @@ export interface WebUserNotification {
     logoutRequired?: boolean;
     targetSessionId?: string;
 }
+/** Ephemeral business reminder. It is not a persisted inbox or an acknowledgement record. */
+export interface WebBusinessNotification {
+    id: string;
+    code: string;
+    title: string;
+    subtitle?: string;
+    content: string;
+    dismissible: boolean;
+    actions: WebBusinessNotificationAction[];
+}
+export type WebBusinessNotificationAction = WebBusinessNotificationNavigateAction | WebBusinessNotificationCommandAction;
+export interface WebBusinessNotificationNavigateAction {
+    kind: 'navigate';
+    key: string;
+    label: string;
+    moduleAlias: string;
+    recordId?: string;
+    pageMode?: 'LIST' | 'FORM' | 'DETAIL';
+    query?: Record<string, string>;
+    dismissOnSuccess: boolean;
+}
+export interface WebBusinessNotificationCommandAction {
+    kind: 'command';
+    key: string;
+    label: string;
+    command: string;
+    arguments?: Record<string, unknown>;
+    danger?: boolean;
+    confirmation?: string;
+    dismissOnSuccess: boolean;
+}
 export interface WebBusinessRealtimeEvent {
     type: string;
     moduleAlias: string;
@@ -92,6 +123,8 @@ export interface RecordInlineAction {
     iconName?: RecordInlineActionIconName;
     showLabel?: boolean;
     disabled?: boolean;
+    /** Explains why a visible inline action is unavailable. */
+    disabledReason?: string;
     danger?: boolean;
 }
 export type RecordInlineActionIconName = 'app' | 'check' | 'close' | 'delete' | 'down' | 'edit' | 'export' | 'filter' | 'help' | 'lock' | 'notification' | 'plus' | 'power' | 'reload' | 'save' | 'search' | 'settings';
@@ -104,8 +137,50 @@ export interface CurrentUser {
     passwordChangeRequired?: boolean;
     timeZone?: string;
 }
+export interface CurrentUserProfilePosition {
+    id?: string;
+    title?: string;
+    primary?: boolean;
+}
+export interface CurrentUserEmployeeProfile {
+    id?: string;
+    employeeNo?: string;
+    title?: string;
+    avatarAssetId?: string;
+    mobile?: string;
+    email?: string;
+    organizationId?: string;
+    organizationTitle?: string;
+    departmentId?: string;
+    departmentTitle?: string;
+    contactEditable?: boolean;
+    positions?: CurrentUserProfilePosition[];
+}
+export interface CurrentUserProfile {
+    username?: string;
+    timeZone?: string;
+    employee?: CurrentUserEmployeeProfile;
+}
+export interface UpdateCurrentUserProfileRequest {
+    mobile?: string;
+    email?: string;
+    avatarAssetId?: string;
+}
 export interface SessionContext {
     currentUser: CurrentUser;
+    tenantBranding?: TenantBranding;
+}
+export interface TenantBranding {
+    lightLogo?: string;
+    darkLogo?: string;
+    mode?: 'logoOnly' | 'logoWithTitle';
+    title?: string;
+    subtitle?: string;
+}
+/** Public branding facts for a tenant locked by the unauthenticated login URL. */
+export interface TenantLoginContext {
+    tenantId: string;
+    branding?: TenantBranding;
 }
 export interface LoginRequest {
     tenantId?: string;
@@ -374,6 +449,13 @@ export interface ViewFieldDefinition {
     /** Maximum visible lines for text cells in standard list views. Omitted uses the platform default of one line. */
     maxDisplayLines?: number;
 }
+/** Semantic group that owns a contiguous set of standard-form fields. */
+export interface FormGroupDescriptor {
+    groupCode: string;
+    title: string;
+    subtitle?: string;
+    fields: ViewFieldRef[];
+}
 export interface BooleanStatusPresentation {
     trueLabel: string;
     falseLabel: string;
@@ -438,6 +520,7 @@ export interface ViewDefinition {
     clientType?: ModuleUiClientType;
     title?: string;
     fields: ViewFieldDefinition[];
+    formGroups?: FormGroupDescriptor[];
 }
 export interface ResolvedViewDescriptor {
     viewCode: string;
@@ -447,7 +530,72 @@ export interface ResolvedViewDescriptor {
     fields: ResolvedViewFieldDescriptor[];
     /** Dynamic-page provenance used to select the view configured by a menu entry. */
     sourceUiConfigId?: string;
-    scopedListWorkspace?: ResolvedScopedListWorkspaceDescriptor;
+    formGroups?: FormGroupDescriptor[];
+}
+export type ModulePageTemplate = 'FLAT_MANAGEMENT' | 'LIST_DETAIL_CARD' | 'TREE_MANAGEMENT';
+export interface ResolvedPageExplorerDescriptor {
+    title: string;
+    searchPlaceholder: string;
+    emptyDescription: string;
+    recordLabel: string;
+    fallbackTitle: string;
+    titleField: string;
+    secondaryField?: string;
+    mutedWhenDisabled: boolean;
+}
+export interface ResolvedPageNavigatorDescriptor {
+    levels: ResolvedPageNavigatorLevelDescriptor[];
+    contextBindings: ResolvedPageContextBindingDescriptor[];
+}
+export interface ResolvedPageNavigatorLevelDescriptor {
+    key: string;
+    kind: 'TREE' | 'MICRO_LIST';
+    sourceModuleAlias: string;
+    title: string;
+    searchPlaceholder: string;
+    /** Presentation policy applied after the source has authoritatively loaded. */
+    singleResultPolicy?: 'NONE' | 'AUTO_SELECT' | 'AUTO_SELECT_AND_HIDE';
+    /** Session-derived source scope, enforced by the source reference transport. */
+    sourceScope?: 'NONE' | 'CURRENT_TENANT';
+    /** When present, the navigator source exposes its own standard CRUD affordances in place. */
+    management?: ResolvedPageNavigatorManagementDescriptor;
+}
+export interface ResolvedPageContextBindingDescriptor {
+    source: 'SESSION' | 'NAVIGATOR';
+    sourceKey: string;
+    target: 'LIST_QUERY' | 'NAVIGATOR_QUERY' | 'FORM_DEFAULT' | 'PICKER_QUERY' | 'MUTATION_CONSTRAINT';
+    targetKey: string;
+    targetNavigatorLevelKey?: string;
+    /** Field name of the record picker which receives this query context. */
+    targetPickerFieldKey?: string;
+}
+export interface ResolvedPageNavigatorManagementDescriptor {
+    /** Optional named source-module form; the default editor is used when omitted. */
+    editorSurface?: string;
+}
+export interface ResolvedPageListDescriptor {
+    searchPlaceholder: string;
+    fields: ResolvedViewDescriptor;
+}
+export interface ResolvedPageDetailDescriptor {
+    emptyDescription: string;
+    createTitle: string;
+    display?: ResolvedViewDescriptor;
+    /** Omitted by an editorless page; standard mutation actions remain governed by the runtime action contract. */
+    editor?: ResolvedViewDescriptor;
+    /** Stable client registration key for an independently restorable detail workbench view. */
+    workspaceView?: ResolvedPageDetailWorkspaceViewDescriptor;
+}
+export interface ResolvedPageDetailWorkspaceViewDescriptor {
+    type: string;
+}
+export interface ResolvedModulePageDescriptor {
+    template: ModulePageTemplate;
+    explorer?: ResolvedPageExplorerDescriptor;
+    navigator?: ResolvedPageNavigatorDescriptor;
+    list?: ResolvedPageListDescriptor;
+    detail: ResolvedPageDetailDescriptor;
+    traits: ('STANDARD_CRUD' | 'ENABLED_STATUS' | 'RECYCLE_BIN' | 'RESPONSIVE_DETAIL_SURFACE')[];
 }
 export interface ResolvedUiActionConfirmationDescriptor {
     mode: 'typedText';
@@ -457,38 +605,36 @@ export interface ResolvedUiActionDescriptor {
     actionCode: string;
     confirmation?: ResolvedUiActionConfirmationDescriptor;
 }
-export interface ResolvedScopedListWorkspaceDescriptor {
-    scopeModuleAlias: string;
-    scopeField: string;
-    queryCriteriaKey: string;
-    scopeTitle: string;
-    scopeSearchPlaceholder: string;
-    /** Scope list items only show a secondary label when the descriptor explicitly enables it. */
-    showScopeItemSubtitle: boolean;
-    createPolicy: 'REQUIRE_SCOPE' | 'ALLOW_UNSCOPED';
-    manageScopeTree?: boolean;
-}
 /** Source-neutral runtime fact for one persisted MuYunFileServer field. */
 export interface ResolvedFileReferenceFieldDescriptor {
     fieldRef: ViewFieldRef;
     allowedMediaTypes: string[];
     maxFileSizeBytes?: number;
     maxFiles: number;
+    storagePolicy: 'MUYUN_FILE_SERVER' | 'DATABASE_INLINE';
     uploadAvailable: boolean;
-}
-export interface ModuleUiDefinition {
-    moduleAlias: string;
-    views: ViewDefinition[];
+    readAvailable: boolean;
 }
 export interface ResolvedModuleUiDescriptor {
     schemaVersion: string;
     moduleAlias: string;
     moduleKind?: 'STATIC' | 'DYNAMIC';
     title?: string;
-    views: ResolvedViewDescriptor[];
     actions?: ResolvedUiActionDescriptor[];
     recordLabelField?: string;
     fileReferences?: ResolvedFileReferenceFieldDescriptor[];
+    page?: ResolvedModulePageDescriptor;
+    defaultEditor?: ResolvedViewDescriptor;
+    editorSurfaces?: ResolvedEditorSurfaceDescriptor[];
+    editorContributions?: ResolvedPageDetailEditorContribution[];
+}
+export interface ResolvedEditorSurfaceDescriptor {
+    key: string;
+    editor: ResolvedViewDescriptor;
+}
+export interface ResolvedPageDetailEditorContribution {
+    resource: string;
+    editor: ResolvedViewDescriptor;
 }
 export interface StandardEntity {
     id?: string;
@@ -816,6 +962,11 @@ export interface ModuleMetadataRelation extends StandardSortableEntity {
 }
 export interface Tenant extends StandardEnabledSortableEntity {
     alias?: string;
+    lightLogoAssetId?: string;
+    darkLogoAssetId?: string;
+    workbenchBrandMode?: 'logoOnly' | 'logoWithTitle';
+    workbenchTitle?: string;
+    workbenchSubtitle?: string;
 }
 export interface FieldSpec extends StandardEnabledSortableEntity {
     alias?: string;

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

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

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

@@ -1,7 +1,8 @@
-import type { ChangeOwnPasswordRequest, CurrentUser, LoginRequest, LoginResult, MenuMineResponse, PageBootstrap } from '../web-contracts/index';
+import type { ChangeOwnPasswordRequest, CurrentUserProfile, CurrentUser, LoginRequest, LoginResult, UpdateCurrentUserProfileRequest, MenuMineResponse, PageBootstrap, TenantBranding, TenantLoginContext } from '../web-contracts/index';
 import type { HttpClient } from './http';
 export interface SessionClient {
     current(): Promise<CurrentUser>;
+    tenantBranding?(): Promise<TenantBranding>;
 }
 export interface MenuClient {
     mine(): Promise<MenuMineResponse>;
@@ -13,9 +14,16 @@ export interface PageBootstrapClient {
 export interface AuthClient {
     login(request: LoginRequest): Promise<LoginResult>;
     changeOwnPassword(request: ChangeOwnPasswordRequest, token: string): Promise<void>;
+    currentProfile(token: string): Promise<CurrentUserProfile>;
+    updateCurrentProfile(request: UpdateCurrentUserProfileRequest, token: string): Promise<CurrentUserProfile>;
     logout(token?: string): Promise<void>;
 }
+/** Resolves the public context used by a tenant-locked login entry. */
+export interface LoginContextClient {
+    loginContext(tenantId: string): Promise<TenantLoginContext>;
+}
 export declare function createSessionClient(http: HttpClient): SessionClient;
+export declare function createLoginContextClient(http: HttpClient): LoginContextClient;
 export declare function createMenuClient(http: HttpClient): MenuClient;
 export declare function createPageBootstrapClient(http: HttpClient): PageBootstrapClient;
 /**

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

@@ -2,7 +2,10 @@ export * from './errors';
 export * from './http';
 export * from './query';
 export * from './actionResult';
+export * from './businessNotifications';
 export * from './dataChanges';
 export * from './realtime';
 export * from './clients';
+export { userPreferences } from './userPreferences';
+export type { UserPreferenceOptions, UserPreferenceStore } from './userPreferences';
 export * from './module/index';

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

@@ -3,4 +3,6 @@ import type { MenuClient, SessionClient } from './index';
 export declare function createMockSessionClient(currentUser?: CurrentUser): SessionClient;
 export declare function createMockMenuClient(records?: WebTreeNode<MenuRecord>[]): MenuClient;
 export declare const mockCurrentUser: CurrentUser;
-export declare const mockMenuTree: WebTreeNode<MenuRecord>[];
+type MockMenuNode = WebTreeNode<MenuRecord>;
+export declare const mockMenuTree: MockMenuNode[];
+export {};

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,24 @@
+export interface UserPreferenceOptions {
+    /**
+     * Local persistence is the default. `backend` reserves the preference for the current account
+     * and never silently falls back to device-local storage.
+     */
+    persistence?: 'local' | 'backend';
+}
+export interface UserPreferenceStore {
+    get<T>(key: string, fallback: T): T;
+    restore<T>(key: string, fallback: T, options?: UserPreferenceOptions): Promise<T>;
+    set<T>(key: string, value: T, options?: UserPreferenceOptions): Promise<void>;
+    remove(key: string, options?: UserPreferenceOptions): Promise<void>;
+}
+/** Internal application-composition bridge; business code only uses userPreferences. */
+export interface UserPreferenceBackend {
+    load(key: string): Promise<string | undefined>;
+    save(key: string, valueJson: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+export declare function configureUserPreferenceBackend(value: UserPreferenceBackend | undefined): void;
+/**
+ * Source-neutral user preference facade. Platform code owns the active persistence route.
+ */
+export declare const userPreferences: UserPreferenceStore;

package/dist/{useUserSessionRows-DX9qYU5r.js → useUserSessionRows-DCpUZCzN.js}

@@ -1,5 +1,5 @@
-import { $ as e } from "./platform-components-DuAohqJO.js";
-import { t } from "./pageRealtime-Be2xkeKK.js";
+import { nt as e } from "./platform-components-CFU_zR7-.js";
+import { t } from "./pageRealtime-EAiGWKEo.js";
 import { ref as n } from "vue";
 //#region src/views/useUserSessionRows.ts
 function r(r) {