@ximatai/muyun-web-app 0.26.14 → 0.26.16

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

@@ -0,0 +1,213 @@
+import type { TextPresentationDocument } from './index';
+/** Bounded business clauses; grouping must not force the loss of explicit requirements. */
+export declare const constructionPlanLimits: {
+    readonly textItems: 64;
+    readonly structuredItems: 16;
+    readonly contentBytes: number;
+};
+/** Requirements consensus; never an executable schema or publication approval. */
+export interface ConstructionPlanContent {
+    title: string;
+    goal: string;
+    inScope: string[];
+    outOfScope: string[];
+    objects: {
+        key: string;
+        name: string;
+        purpose: string;
+        moduleAlias?: string | null;
+    }[];
+    relationships: string[];
+    rules: string[];
+    questions: string[];
+    assumptions: string[];
+    decisions: {
+        statement: string;
+        source: 'USER_REQUIREMENT' | 'RECOMMENDATION';
+    }[];
+    acceptanceExamples: string[];
+    requirements?: ConstructionRequirement[];
+}
+export interface ConstructionPlanSnapshot {
+    planId: string;
+    revision: number;
+    content: ConstructionPlanContent;
+    confirmedAt: string;
+    constructionStatus: 'NOT_STARTED' | 'LINKED' | 'INITIALIZED' | 'PARTIALLY_DELIVERED' | 'DELIVERED';
+    deliveredObjectKeys: string[];
+    /** Current explicit associations; old snapshots may only carry historical initialization receipts. */
+    moduleBindings?: {
+        objectKey: string;
+        moduleAlias: string;
+    }[];
+    initializations: ConstructionInitialization[];
+    fieldChanges: ConstructionFieldReceipt[];
+    deliveries: ConstructionDeliveryReceipt[];
+}
+export interface ConstructionPlanSummary {
+    planId: string;
+    title: string;
+    revision: number;
+    updatedAt: string;
+}
+export interface ConstructionInitialization {
+    objectKey: string;
+    planRevision: number;
+    moduleAlias: string;
+    metadataId: string;
+    relationId: string;
+    requestId: string;
+}
+export interface ConstructionInitializationResult {
+    receipt: ConstructionInitialization;
+    runtime: import('./index').DynamicRuntimeActivationStatus | null;
+}
+export interface ConstructionField {
+    name: string;
+    title: string;
+    specAlias: string;
+    required: boolean;
+    unique: boolean;
+    indexed: boolean;
+    titleField?: boolean;
+    reference?: {
+        targetModuleAlias: string;
+        targetMetadataId: string | null;
+        targetKeyField: string;
+        targetLabelField: string;
+        cardinality: 'ONE';
+        targetUnavailablePolicy: 'PRESERVE_HISTORY';
+        requireEnabled: boolean;
+        projectionMappings: string[];
+    } | null;
+}
+export interface ConstructionFieldDescription {
+    children?: Record<string, {
+        relation: import('./index').ModuleMetadataRelation;
+        metadataVersion: number;
+        fields: import('./index').MetadataField[];
+        references: Record<string, NonNullable<ConstructionField['reference']>>;
+    }>;
+    calculationRules?: {
+        alias: string;
+        targetField?: string | null;
+        expression: string;
+        version?: number;
+    }[];
+    moduleAlias: string;
+    planRevision: number;
+    metadataVersion: number;
+    references?: Record<string, NonNullable<ConstructionField['reference']>>;
+    fields: import('./index').MetadataField[];
+    specs: {
+        alias: string;
+        title: string;
+        type: string;
+        length: number | null;
+        precision: number | null;
+        scale: number | null;
+    }[];
+}
+export interface ConstructionFieldReceipt {
+    requestId: string;
+    objectKey: string;
+    planRevision: number;
+    moduleAlias: string;
+    fields: ConstructionField[];
+}
+export interface ConstructionFieldResult {
+    receipt: ConstructionFieldReceipt;
+    runtime: import('./index').DynamicRuntimeActivationStatus | null;
+}
+export interface ConstructionDeliveryProposal {
+    childFields?: Record<string, string[]>;
+    planRevision: number;
+    objectKey: string;
+    kind: 'PAGE' | 'ENTRY';
+    title: string;
+    listFields: string[];
+    formFields: string[];
+    searchFields: string[];
+}
+export interface ConstructionDeliveryPreview {
+    proposal: ConstructionDeliveryProposal;
+    moduleAlias: string;
+    lines: string[];
+    fingerprint: string;
+}
+export interface ConstructionDeliveryReceipt {
+    requestId: string;
+    objectKey: string;
+    planRevision: number;
+    kind: 'PAGE' | 'ENTRY';
+    moduleAlias: string;
+    pageId: string;
+    variantId: string;
+    revisionId: string;
+    menuId: string | null;
+    metadataVersion: number;
+}
+export interface ConstructionProgress extends TextPresentationDocument {
+    objectKey: string;
+    moduleAlias: string;
+    runtimeStatus: string;
+    pagePublished: boolean;
+    entryVisible: boolean;
+    menuId: string | null;
+    needsReview: boolean;
+    acceptanceConfirmed: boolean;
+    /** Configuration progress is not an observation of tenant business records. */
+    businessDataStatus: 'NOT_QUERIED';
+    remainingWork: string[];
+    receipts: ConstructionDeliveryReceipt[];
+    requirements?: ConstructionRequirementEvidence[];
+}
+export interface ConstructionAcceptancePreview extends TextPresentationDocument {
+    objectKey: string;
+    planRevision: number;
+    checks: string[];
+    fingerprint: string;
+}
+export interface ConstructionAcceptanceReceipt {
+    requestId: string;
+    objectKey: string;
+    planRevision: number;
+    baseline: string;
+}
+export interface ConstructionRequirement {
+    section: 'SCOPE' | 'RULE' | 'RELATION';
+    index: number;
+    objectKey: string;
+    mode: 'FIELD' | 'REQUIRED' | 'UNIQUE' | 'REFERENCE' | 'CHILD' | 'CALCULATION' | 'MANUAL' | 'UNSUPPORTED';
+    fieldName: string;
+    explanation: string;
+    reference?: {
+        objectKey: string;
+        moduleAlias: string;
+    } | null;
+}
+export interface ConstructionRequirementEvidence {
+    section: ConstructionRequirement['section'];
+    index: number;
+    statement: string;
+    objectKey: string;
+    fieldName: string;
+    status: 'UNMAPPED' | 'UNSUPPORTED' | 'CONFIGURATION_MISSING' | 'CONFIGURATION_MATCHED' | 'MANUAL_RESPONSIBILITY';
+    explanation: string;
+}
+export interface ConstructionTask extends TextPresentationDocument {
+    planRevision: number;
+    /** Requirements whose object ownership has not been confirmed, reported once for the plan. */
+    unmappedRequirements: ConstructionRequirementEvidence[];
+    objects: {
+        objectKey: string;
+        title: string;
+        complete: boolean;
+        options: {
+            action: 'REVIEW_CURRENT_CONFIGURATION' | 'REVIEW_REQUIREMENTS' | 'INITIALIZE' | 'VERIFY_RUNTIME' | 'CONFIGURE_FIELDS' | 'REVIEW_CONFIGURATION' | 'PUBLISH_PAGE' | 'CREATE_ENTRY' | 'VERIFY_BUSINESS';
+            explanation: string;
+        }[];
+        requirements: ConstructionRequirementEvidence[];
+        progress?: Pick<ConstructionProgress, 'moduleAlias' | 'runtimeStatus' | 'pagePublished' | 'entryVisible' | 'menuId' | 'needsReview' | 'acceptanceConfirmed' | 'businessDataStatus' | 'remainingWork'> | null;
+    }[];
+}

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

@@ -43,7 +43,32 @@ export interface WebDataChange {
     [key: string]: unknown;
 }
 export type WebActionMessageType = 'SUCCESS' | 'INFO' | 'WARNING' | 'ERROR' | string;
+export interface TextReference {
+    sourceKind: 'CODE' | 'CONFIG';
+    sourceId: string;
+    sourceVersion: string;
+    originalText: string;
+}
+export interface TextPresentation {
+    source: TextReference;
+    languages: Record<string, {
+        text: string;
+        requestedTag: string;
+        resourceTag?: string | null;
+        missing: boolean;
+        fallback: boolean;
+    }>;
+}
+/** Read-only labels on explicitly opted-in configuration records. Raw fields remain authoritative. */
+export interface RecordTextPresentation {
+    $texts?: Readonly<Record<string, TextPresentation>>;
+}
+/** Server-issued addresses of display slots; never addresses of business record values. */
+export interface TextPresentationDocument {
+    textBindings?: Record<string, TextPresentation>;
+}
 export interface WebActionMessage {
+    textSource?: TextReference;
     code?: string;
     text?: string;
     type?: WebActionMessageType;
@@ -78,6 +103,7 @@ export interface WebUserNotification {
 }
 /** Ephemeral business reminder. It is not a persisted inbox or an acknowledgement record. */
 export interface WebBusinessNotification {
+    textResources?: Record<string, TextPresentation>;
     id: string;
     code: string;
     title: string;
@@ -410,6 +436,10 @@ export declare function hasExecutableDetailRelationMutationContract(relation: Re
 };
 export type MenuEntryType = 'module' | 'route' | 'link';
 export interface MenuRecord extends StandardEnabledTreeEntity {
+    /** Display-only navigation resource; configuration reads continue to expose the original. */
+    titleText?: TextPresentation;
+    /** Read-only hint from the target module; never maintained on menus. */
+    moduleDescription?: string;
     id: string;
     title: string;
     schemeId: string;
@@ -490,6 +520,7 @@ export interface PageDescriptorBase<TPageType extends PageType, TOpenMode extend
     openMode: TOpenMode;
     hostType: THostType;
     title?: string;
+    titleText?: TextPresentation;
     /** Defaults to flow when omitted, preserving ordinary route behaviour. */
     layout?: PageLayoutMode;
     menuId?: string;
@@ -633,6 +664,9 @@ export interface WebReferenceResolveRequest {
 export interface WebReferenceResolveItem {
     id: string;
     title?: string;
+    titleText?: TextPresentation;
+    /** Public, source-declared candidate context; never an arbitrary projection dump. */
+    subtitle?: string;
     matchedBy?: WebReferenceMatchMode;
     projections?: Record<string, unknown>;
     affectPatch?: Record<string, unknown>;
@@ -661,6 +695,7 @@ export type QueryOperator = 'EQ' | 'NOT_EQUAL' | 'LIKE' | 'IN' | 'NOT_IN' | 'GT'
 export interface QuerySchemaField {
     name: string;
     title?: string;
+    titleText?: TextPresentation;
     valueType: QueryValueType;
     operators: QueryOperator[];
     defaultOperator?: QueryOperator;
@@ -678,6 +713,7 @@ export interface QuerySchemaField {
 export interface QuerySchemaPersistentControl {
     id: string;
     title: string;
+    titleText?: TextPresentation;
     operator: QueryOperator;
     defaultValues?: unknown[];
 }
@@ -743,7 +779,9 @@ export interface ViewFieldRef {
     fieldName: string;
     fieldId?: string;
 }
+export type AssistantFieldPolicy = 'HIDDEN' | 'DESCRIBE' | 'READ' | 'READ_WRITE';
 export interface ViewFieldDefinition {
+    assistantPolicy?: AssistantFieldPolicy;
     fieldRef: ViewFieldRef;
     label?: string;
     visible?: UiRule<boolean>;
@@ -795,6 +833,18 @@ export interface ResolvedFieldControlBindingDescriptor {
     valueType: string;
 }
 export interface ResolvedViewFieldDescriptor {
+    /** Computed values are previews or are unavailable until the next successful save. */
+    calculationTiming?: 'IMMEDIATE' | 'ON_SAVE' | null;
+    inputRequirements?: {
+        requiredOnInsert: boolean;
+        requiredOnUpdate: boolean;
+        maxLength?: number | null;
+        validationRegex?: string | null;
+        textNormalization?: 'NONE' | 'TRIM' | 'TRIM_TO_NULL' | null;
+        precision?: number | null;
+        scale?: number | null;
+    };
+    assistantPolicy?: AssistantFieldPolicy;
     fieldRef: ViewFieldRef;
     label?: string;
     visible?: UiRule<boolean>;
@@ -876,6 +926,8 @@ export interface ResolvedOptionFieldDescriptor {
     inlineItems?: OptionItemDescriptor[];
 }
 export interface OptionItemDescriptor {
+    titleSource?: TextReference;
+    titleText?: TextPresentation;
     code: string;
     title: string;
     enabled: boolean;
@@ -1096,6 +1148,7 @@ export interface ResolvedFileReferenceFieldDescriptor {
     readAvailable: boolean;
 }
 export interface ResolvedModuleUiDescriptor {
+    sourceTexts?: Record<string, TextReference>;
     schemaVersion: string;
     moduleAlias: string;
     moduleKind?: 'STATIC' | 'DYNAMIC';
@@ -1610,3 +1663,28 @@ export interface PurgeReport {
     purgeOperationId: string;
     entries: PurgeEntryResult[];
 }
+/** Committed configuration and the projections installed in the node serving this response. */
+export interface DynamicRuntimeActivationStatus {
+    moduleAlias: string;
+    desiredRevision: number | null;
+    lastSuccessfulRevision: number | null;
+    installedRevision: number | null;
+    status: 'UNTRACKED' | 'PENDING' | 'ACTIVE' | 'INACTIVE' | 'FAILED';
+    failureMessage: string | null;
+    attemptedAt: string | null;
+}
+export * from './constructionPlan';
+export type { ConstructionRequirement, ConstructionRequirementEvidence, ConstructionTask, } from './constructionPlan';
+export type { ReferenceTargetFieldCatalog, ReferenceTargetFieldCandidate } from './referenceTarget';
+export * from './operation';
+export type { WorkflowTaskPreparation, WorkflowConfigurationCatalog, WorkflowDefinitionSelection, WorkflowDefinitionCreate, WorkflowAdminInstance, WorkflowAdminTask, WorkflowAdminInstanceQuery, WorkflowAdminHistoryQuery, WorkflowDefinition, WorkflowHistoryInstance, WorkflowVersion, WorkflowNode, WorkflowRoute, WorkflowAddSignExplanation, WorkflowDesign, WorkflowInstance, WorkflowTask, WorkflowEvent, WorkflowAction, WorkflowStatus, WorkflowRenderBundle, WorkflowSubmitPreview, WorkflowBranch, WorkflowWorkbenchCard, WorkflowWorkbenchFilters, } from './workflow';
+/** Shared directory labels; titles remain separate from business records and page-specific captions. */
+export interface ModuleTitleView {
+    moduleAlias: string;
+    title: string;
+    titleSource?: TextReference;
+    titleText?: TextPresentation;
+}
+export interface ModuleTitleCatalog {
+    modules: Record<string, ModuleTitleView>;
+}

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

@@ -0,0 +1,33 @@
+/** Platform operation presentation; never interpreted from model prose. */
+export interface OperationPresentation {
+    title: string;
+    lines: string[];
+    /** Secondary, fully reviewable details; never used as an execution payload. */
+    details?: {
+        title: string;
+        lines: string[];
+    };
+}
+/** A bounded read-only pointer, never an executable command or authority. */
+export type OperationReceiptReference = {
+    kind: 'record-save';
+    moduleAlias: string;
+    requestId: string;
+    tenantId?: string;
+    menuId?: string;
+    pageContext?: Record<string, string>;
+    pageSelection?: {
+        kind: string;
+        key: string;
+    };
+} | {
+    kind: 'child-metadata';
+    moduleAlias: string;
+    relationId: string;
+    requestId: string;
+} | {
+    kind: 'page-publication';
+    variantId: string;
+    revisionId: string;
+    contentDigest: string;
+};

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

@@ -0,0 +1,13 @@
+/** Configuration directory shared by standard editors and application construction. */
+export interface ReferenceTargetFieldCandidate {
+    fieldName: string;
+    title: string;
+    defaultField: boolean;
+    selectable: boolean;
+}
+export interface ReferenceTargetFieldCatalog {
+    targetModuleAlias: string;
+    targetMetadataId: string | null;
+    keyFields: ReferenceTargetFieldCandidate[];
+    labelFields: ReferenceTargetFieldCandidate[];
+}