@ximatai/muyun-web-app 0.26.11 → 0.26.13

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,17 +41,19 @@ export interface ModuleRecordActionDecision {
 }
 export interface ModuleRuntimeContext {
     moduleAlias: string;
+    tenantRequired?: boolean;
     title?: string;
-    moduleKind?: 'STATIC' | 'DYNAMIC';
+    /** Stable wire code of the registered module kind. */
+    moduleKind?: 'static' | 'dynamic';
     entryType?: 'module' | 'route' | 'link';
     entryRoute?: string;
     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 {
@@ -65,5 +70,5 @@ export interface ModuleRuntimeContextState {
     recordActionsSnapshot(recordId: string): ModuleRecordActionAvailability | undefined;
     invalidateRecordActions?(recordIds?: string[]): void;
 }
-export declare function createModuleRuntimeContextState(http: HttpClient, moduleAlias: string, access?: 'MENU' | 'REFERENCE'): ModuleRuntimeContextState;
+export declare function createModuleRuntimeContextState(http: HttpClient, moduleAlias: string, access?: 'MENU' | 'REFERENCE' | 'VIEW'): ModuleRuntimeContextState;
 export declare function isRuntimeAbilityAvailable(context: ModuleRuntimeContext | undefined, ability: ModuleAbilityCode): boolean;

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>;
@@ -57,11 +64,15 @@ export declare function createManagedDetailRelationClient<TRecord>(http: HttpCli
 export declare function createModuleCrudClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
 }): ModuleCrudClient<TRecord>;
+/** Persisted selection recovery shares the module wire normalization used by candidate queries. */
+export interface NavigatorReferenceCrudClient<TRecord> extends ModuleCrudClient<TRecord> {
+    translate(ids: readonly string[]): Promise<WebPageResponse<TRecord>>;
+}
 /** The navigation-only read surface deliberately does not reuse the module query endpoint. */
 export declare function createNavigatorReferenceCrudClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
     navigatorReference?: NavigatorReferenceRequestContext;
-}): ModuleCrudClient<TRecord>;
+}): NavigatorReferenceCrudClient<TRecord>;
 export declare function createStaticResourceCrudClient<TRecord>(http: HttpClient, resourcePath: string): ModuleCrudClient<TRecord>;
 export declare function createModuleTreeClient<TRecord>(http: HttpClient, options: {
     moduleAlias: string;
@@ -83,3 +94,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>;