@ximatai/muyun-web-app 0.26.11 → 0.26.12

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

@@ -84,7 +84,12 @@ export interface WebBusinessNotification {
     content: string;
     dismissible: boolean;
     actions: WebBusinessNotificationAction[];
+    /** Optional standard card accent. Omit it to use the neutral platform presentation. */
+    tone?: WebBusinessNotificationTone;
+    /** The business fact's occurrence time, displayed in the workbench time zone when supplied. */
+    occurredAt?: string;
 }
+export type WebBusinessNotificationTone = 'default' | 'success' | 'danger';
 export type WebBusinessNotificationAction = WebBusinessNotificationNavigateAction | WebBusinessNotificationRecordAction;
 export interface WebBusinessNotificationNavigateAction {
     kind: 'navigate';
@@ -129,6 +134,8 @@ export interface WebTreeNode<T> {
  * them to their own icon implementations.
  */
 export interface RecordInlineAction {
+    /** Optional single-level menu, rendered in the same stable inline action slot. */
+    items?: Array<Pick<RecordInlineAction, 'key' | 'title' | 'disabled' | 'danger'>>;
     key: string;
     /** Standard record action whose availability is resolved for the rendered record. */
     actionCode?: string;
@@ -140,7 +147,7 @@ export interface RecordInlineAction {
     disabledReason?: string;
     danger?: boolean;
 }
-export type RecordInlineActionIconName = 'app' | 'check' | 'close' | 'delete' | 'down' | 'edit' | 'export' | 'filter' | 'help' | 'lock' | 'notification' | 'plus' | 'power' | 'reload' | 'save' | 'search' | 'settings';
+export type RecordInlineActionIconName = 'app' | 'check' | 'close' | 'delete' | 'down' | 'edit' | 'export' | 'eye' | 'eye-off' | 'filter' | 'help' | 'lock' | 'notification' | 'plus' | 'power' | 'reload' | 'save' | 'search' | 'settings';
 export interface CurrentUser {
     userId: string;
     username?: string;
@@ -258,6 +265,8 @@ export interface PageBootstrapActionBlock {
     key?: string;
     actionCode: string;
     title?: string;
+    /** Business importance only; card shells decide direct display or “更多”. */
+    importance?: 'PRIMARY' | 'STANDARD' | 'SECONDARY';
     position?: string;
     targetUiConfigId?: string;
     submitPath?: string;
@@ -382,6 +391,8 @@ export interface ResolvedDetailRelationListField {
     title?: string;
     fieldForm?: string;
     fieldUiControlAlias?: string;
+    /** Source-neutral scalar value fact used by relation previews and portable list renderers. */
+    valueType?: ViewFieldValueType | string;
     width?: number;
     align?: 'left' | 'center' | 'right' | string;
     maxDisplayLines?: number;
@@ -626,6 +637,8 @@ export interface QuerySchemaField {
     defaultOperator?: QueryOperator;
     quickSearch?: boolean;
     sortable?: boolean;
+    /** Explicit field-domain binding; distinguishes options from reference title companions. */
+    optionBinding?: OptionBindingDescriptor;
     optionTitleField?: string;
 }
 export interface QuerySchemaQuickSearch {
@@ -665,7 +678,7 @@ export interface UiFormula {
 /** Versioned program compiled by FormulaEngine. The browser executes it locally and never parses expression. */
 export interface FormulaProgram {
     schemaVersion: number;
-    profile: 'WEB_UI' | 'PAGE_TEXT' | 'FORM_COMPUTE';
+    profile: 'WEB_UI' | 'PAGE_TEXT' | 'FORM_COMPUTE' | 'FORM_VALIDATION';
     root: FormulaNode;
     referencedFields: string[];
 }
@@ -777,6 +790,8 @@ export interface ResolvedReferenceFieldDescriptor {
     candidateDependencies?: ReferenceCandidateDependency[];
     /** Read-side title projection for this scalar reference, when supplied by the server. */
     titleField?: string;
+    /** Target fields mapped by metadata to read-only source-record display projections. */
+    displayProjections?: ResolvedReferenceDisplayProjectionDescriptor[];
     /**
      * Explicitly authorized target-field paths available after choosing this ONE reference.
      * Paths are relative to this reference field; the form runtime prefixes them with the
@@ -791,6 +806,10 @@ export interface ResolvedReferenceFieldDescriptor {
 export interface ResolvedReferenceSelectionProjectionDescriptor {
     path: string[];
 }
+export interface ResolvedReferenceDisplayProjectionDescriptor {
+    targetField: string;
+    outputField: string;
+}
 export interface ReferenceCandidateDependency {
     sourceField: string;
     targetField: string;
@@ -832,6 +851,14 @@ export interface ResolvedFormComputeRuleDescriptor {
     triggerFields: string[];
     writePolicy: 'ALWAYS';
 }
+/** Server-issued browser pre-save validation; the server enforces the same rule on mutation. */
+export interface ResolvedFormValidationRuleDescriptor {
+    code: string;
+    program: FormulaProgram;
+    inputFields: string[];
+    targetField?: string;
+    message: string;
+}
 export interface ResolvedViewDescriptor {
     viewCode: string;
     viewKind: ModuleViewKind;
@@ -842,6 +869,7 @@ export interface ResolvedViewDescriptor {
     sourceUiConfigId?: string;
     formGroups?: FormGroupDescriptor[];
     formComputeRules?: ResolvedFormComputeRuleDescriptor[];
+    formValidationRules?: ResolvedFormValidationRuleDescriptor[];
 }
 export type ModulePageTemplate = 'FLAT_MANAGEMENT' | 'LIST_DETAIL_CARD' | 'TREE_MANAGEMENT';
 export interface ResolvedPageExplorerDescriptor {
@@ -877,7 +905,7 @@ export interface ResolvedPageNavigatorLevelDescriptor {
      */
     sourceScope?: 'NONE' | 'CURRENT_TENANT';
     /** When present, the navigator source exposes its own standard CRUD affordances in place. */
-    management?: ResolvedPageNavigatorManagementDescriptor;
+    management?: ResolvedPageNavigatorManagementDescriptor | null;
 }
 export interface ResolvedPageContextBindingDescriptor {
     source: 'SESSION' | 'NAVIGATOR' | 'RESOLVED_SELECTION';
@@ -915,10 +943,14 @@ export interface ResolvedPageTextDescriptor {
 export interface ResolvedPageListQuerySummaryDescriptor {
     key: string;
     title: string;
-    source: 'MATCHED_COUNT' | 'CONTRIBUTOR';
+    source: 'MATCHED_COUNT' | 'SUM' | 'CONTRIBUTOR' | 'GROUPED';
+    fieldName?: string;
     contributorKey?: string;
+    groupByField?: string;
+    groupByTitle?: string;
+    sumFieldTitle?: string;
 }
-/** A persistent boolean query control rendered after search and before advanced filtering. */
+/** A persistent boolean query control rendered before search; advanced filtering follows search. */
 export interface ResolvedPageListPersistentQueryControlDescriptor {
     externalCriteriaKey: string;
     title: string;
@@ -944,6 +976,8 @@ export interface ResolvedPageDetailWorkspaceViewDescriptor {
     type: string;
 }
 export interface ResolvedModulePageDescriptor {
+    /** Omitted uses the module default; empty disables page quick search. */
+    quickSearchFields?: string[];
     template: ModulePageTemplate;
     explorer?: ResolvedPageExplorerDescriptor;
     navigator?: ResolvedPageNavigatorDescriptor;
@@ -951,8 +985,24 @@ export interface ResolvedModulePageDescriptor {
     /** Declared action-contribution tree rendered as the main TREE_MANAGEMENT resource. */
     treeResource?: ResolvedPageTreeResourceDescriptor;
     detail: ResolvedPageDetailDescriptor;
+    /** Actions placed only into platform-owned page regions. */
+    actions?: ResolvedPageActionDescriptor[];
+    managedActions?: boolean;
     traits: ('STANDARD_CRUD' | 'ENABLED_STATUS' | 'RECYCLE_BIN' | 'RESPONSIVE_DETAIL_SURFACE')[];
 }
+/** Compiled transport for an action that explicitly supports a standard page surface. */
+export interface PageActionInvocation {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    input: 'NONE' | 'FORM_RECORD';
+}
+export interface ResolvedPageActionDescriptor {
+    title?: string;
+    operation?: string;
+    actionCode: string;
+    anchor: 'PAGE' | 'DETAIL' | 'FORM';
+    invocation?: PageActionInvocation;
+}
 export interface ResolvedPageTreeResourceDescriptor {
     resource: string;
     scopeNavigatorKey: string;
@@ -963,6 +1013,8 @@ export interface ResolvedPageTreeResourceDescriptor {
     title: string;
     emptyDescription: string;
     createTitle: string;
+    /** Persisted fields that define the resource's own server-authoritative sort partition. */
+    sortPartitionFields: string[];
 }
 export interface ResolvedUiActionConfirmationDescriptor {
     mode: 'typedText';
@@ -1268,6 +1320,8 @@ export interface PlatformModule extends StandardEnabledTreeEntity {
 }
 /** A governed operation exposed by one platform module. */
 export interface PlatformModuleAction extends StandardEnabledSortableEntity {
+    bindingPending?: boolean;
+    formSupported?: boolean;
     moduleAlias?: string;
     actionCode?: string;
     entityAlias?: string;
@@ -1323,7 +1377,8 @@ export interface ModuleMetadataRelation extends StandardSortableEntity {
     moduleAlias?: string;
     metadataId?: string;
     relationAlias?: string;
-    relationRole?: 'MAIN' | 'CHILD';
+    /** Runtime APIs serialize Java code enums using their lower-case code; upper-case remains accepted for fixtures. */
+    relationRole?: 'main' | 'child' | 'MAIN' | 'CHILD';
     parentMetadataId?: string;
     foreignKey?: string;
     autoPopulate?: boolean;
@@ -1346,6 +1401,7 @@ export interface FieldSpec extends StandardEnabledSortableEntity {
     queryOperators?: string[];
     defaultUiControlAlias?: string;
     uiControlAliases?: string[];
+    safeTargetFieldSpecAliases?: string[];
 }
 export interface FieldUiControl extends StandardEnabledSortableEntity {
     alias?: string;
@@ -1391,9 +1447,13 @@ export interface DictionaryItem extends StandardEnabledTreeEntity {
     categoryAlias?: string;
     code?: string;
 }
-export interface TreeSortRequest {
+/** Relative placement for a sortable flat record collection. */
+export interface SortRequest {
     previousId?: string | null;
     nextId?: string | null;
+}
+/** Relative placement for a sortable tree record collection. */
+export interface TreeSortRequest extends SortRequest {
     parentId?: string | null;
 }
 export type FieldKind = 'input' | 'select' | 'dictionary-select' | 'reference-select';

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

@@ -4,3 +4,4 @@ export * from './staticModuleClient';
 export type { ModuleActionState, ModuleRecordActionAvailability, ModuleRuntimeAction, ModuleRuntimeContext, ModuleRuntimeContextState, } from './runtimeContext';
 export type { ModuleAbilityClients, ModuleAbilities } from './abilities';
 export * from './moduleContext';
+export * from './pageActionEntries';

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

@@ -1,3 +1,4 @@
+import { type PropType } from 'vue';
 import type { HttpClient } from '../http';
 import { type ModuleAbilities } from './abilities';
 import { type ModuleActionState, type ModuleRecordActionAvailability, type ModuleRuntimeAction, type ModuleRuntimeContextState } from './runtimeContext';
@@ -34,6 +35,20 @@ export declare function createModuleContext<TRecord>(options: ModuleContextOptio
 export declare function createModuleTreeContext<TRecord>(options: ModuleContextOptions): ModuleTreeContext<TRecord>;
 export declare function useModuleContext<TRecord>(options?: Partial<ModuleContextOptions>): ModuleContext<TRecord>;
 export declare function useModuleTreeContext<TRecord>(options?: Partial<ModuleContextOptions>): ModuleTreeContext<TRecord>;
+/** An immutable transport boundary; remount it to begin a separate business data session. */
+export declare const ModuleHttpProvider: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    http: {
+        type: PropType<HttpClient>;
+        required: true;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    http: {
+        type: PropType<HttpClient>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export declare const ModuleContextProvider: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     moduleAlias: {
         type: StringConstructor;

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

@@ -0,0 +1,21 @@
+/** Shared interaction vocabulary for page design and business rendering. */
+export declare function pageActionIntent(code: string, anchor: string): {
+    operation: string;
+    title: string;
+    mode?: "create" | "edit";
+};
+export declare function pageActionEntryTitle(entry: {
+    actionCode: string;
+    anchor: string;
+    title?: string;
+}): string;
+export declare function pageActionEntryVisible(entry: {
+    actionCode: string;
+    anchor: string;
+    hidden?: boolean;
+    operation?: string;
+}, mode: 'view' | 'create' | 'edit'): boolean;
+export declare function pageActionEntryDescription(entry: {
+    actionCode: string;
+    anchor: string;
+}): string;

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

@@ -1,8 +1,11 @@
-import type { ResolvedModuleUiDescriptor } from '../../web-contracts/index';
+import type { PageActionInvocation, ResolvedModuleUiDescriptor } from '../../web-contracts/index';
 import { type AppError } from '../errors';
 import type { HttpClient } from '../http';
 import type { ModuleAbilityCode } from './abilityCodes';
 export interface ModuleRuntimeAction {
+    bindingPending?: boolean;
+    formSupported?: boolean;
+    invocations?: Partial<Record<'PAGE' | 'DETAIL' | 'FORM', PageActionInvocation>>;
     actionCode: string;
     permissionActionCode?: string;
     title?: string;
@@ -38,6 +41,7 @@ export interface ModuleRecordActionDecision {
 }
 export interface ModuleRuntimeContext {
     moduleAlias: string;
+    tenantRequired?: boolean;
     title?: string;
     moduleKind?: 'STATIC' | 'DYNAMIC';
     entryType?: 'module' | 'route' | 'link';
@@ -45,10 +49,10 @@ export interface ModuleRuntimeContext {
     entryExternalUrl?: string;
     mainEntityAlias?: string;
     capabilities: string[];
+    /** Persisted fields that define the server-authoritative sort partition. */
+    sortPartitionFields?: 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 {

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

@@ -1,4 +1,4 @@
-import type { TreeSortRequest, WebActionResultFacts, WebActionResultEnvelope, QuerySchema, WebListResponse, WebPageResponse, WebQueryRequest, WebTreeNode } from '../../web-contracts/index';
+import type { SortRequest, TreeSortRequest, WebActionResultFacts, WebActionResultEnvelope, QuerySchema, WebListResponse, WebPageResponse, WebQueryRequest, WebTreeNode } from '../../web-contracts/index';
 import type { HttpClient } from '../http';
 export interface StaticRecordMutationResult<TRecord> extends WebActionResultFacts {
     record: TRecord;
@@ -21,6 +21,8 @@ export interface ModuleCrudClient<TRecord> {
     delete(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
     enable(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
     disable(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
+    /** Optional capability: plain CRUD consumers must not be forced to implement sorting. */
+    sort?(id: string, request: SortRequest): Promise<StaticCountMutationResult>;
 }
 /** Source-neutral tree extension for a platform module. */
 export interface ModuleTreeClient<TRecord> extends ModuleCrudClient<TRecord> {
@@ -32,7 +34,12 @@ export interface ModuleTreeClient<TRecord> extends ModuleCrudClient<TRecord> {
     subtree(id: string, options?: {
         includeSelf?: boolean;
     }): Promise<WebListResponse<WebTreeNode<TRecord>>>;
-    sort(id: string, request: TreeSortRequest): Promise<StaticCountMutationResult>;
+    sort(id: string, request: TreeSortRequest, options?: TreeSortOptions): Promise<StaticCountMutationResult>;
+}
+export interface TreeSortOptions {
+    externalQueryValues?: Record<string, unknown>;
+    navigatorHostModuleAlias?: string;
+    navigatorTargetLevelKey?: string;
 }
 export interface ModuleEnableClient {
     enable(id: string, request: RecordActionRequest): Promise<StaticCountMutationResult>;
@@ -83,3 +90,19 @@ export type StaticModuleTreeClient<TRecord> = ModuleTreeClient<TRecord>;
 export declare const createStaticModuleCrudClient: typeof createModuleCrudClient;
 /** @deprecated Use createModuleTreeClient. Retained for published consumer compatibility. */
 export declare const createStaticModuleTreeClient: typeof createModuleTreeClient;
+/**
+ * Dynamic records use a typed `{ id, version, values, children }` wire envelope while static
+ * records already publish their fields at the root. The shared module client is the only place
+ * that should bridge this transport difference: every page surface then consumes one flat record
+ * contract, including aggregate children, and submits that same accepted shape back to the
+ * dynamic deserializer.
+ */
+export declare function normalizeModuleRecord<TRecord>(record: TRecord): TRecord;
+/**
+ * Normalizes a page response at the source-neutral module transport boundary.
+ *
+ * <p>Association query contracts use their server-issued route directly instead of the standard
+ * module CRUD path, but they still return the same dynamic record envelope.  Keeping this helper
+ * public lets those descriptor-driven surfaces reuse the one normalization rule.</p>
+ */
+export declare function normalizeModulePageResponse<TRecord>(response: WebPageResponse<TRecord>): WebPageResponse<TRecord>;