@ximatai/muyun-web-app 0.26.10 → 0.26.12

package/dist/types/views/metadataOrchestrationState.d.ts

@@ -1,7 +1,7 @@
 import type { FieldSpec, Metadata, MetadataField, ModuleMetadataRelation } from '../web-contracts/index';
 import type { RecordExplorerItemDescriptor } from '../platform-components/recordExplorerItemModel';
 /** Editor lifecycle of the metadata orchestration workspace. */
-export type MetadataOrchestrationMode = 'view' | 'create-main' | 'create-field' | 'edit-field';
+export type MetadataOrchestrationMode = 'view' | 'create-main' | 'create-field' | 'create-reference-field' | 'create-dictionary-field' | 'edit-field';
 export interface MainMetadataDraft {
     alias: string;
     title: string;
@@ -10,6 +10,52 @@ export interface MainMetadataDraft {
     dataScopeEnabled: boolean;
 }
 export type MetadataFieldDraft = Partial<MetadataField>;
+/**
+ * A field's business property is distinct from its physical field specification.  For example,
+ * a reference can still use a short-text column to store a target key.
+ */
+export type MetadataFieldPropertyKind = 'BASIC' | 'MODULE_REFERENCE' | 'DICTIONARY' | 'LEGACY_LOCKED';
+export interface MetadataFieldReferencePropertyConfig {
+    targetModuleAlias?: string;
+    targetMetadataId?: string;
+    targetKeyField?: string;
+    targetLabelField?: string;
+    cardinality?: 'ONE' | 'MANY';
+    targetUnavailablePolicy?: 'PRESERVE_HISTORY' | 'RESTRICT' | 'CASCADE_DELETE';
+    projectionMappings?: string[];
+}
+export interface MetadataFieldDictionaryPropertyConfig {
+    dictionaryApplicationAlias?: string;
+    dictionaryCategoryAlias?: string;
+    selectionMode?: 'SINGLE' | 'MULTIPLE';
+}
+/**
+ * The platform field-spec catalog owns these stable storage shapes.  A property editor must
+ * select a legal shape rather than exposing every scalar type as a possible reference/dictionary
+ * backing store.
+ */
+export declare function storageFieldSpecAliasOf(kind: MetadataFieldPropertyKind, selectionMode?: MetadataFieldDictionaryPropertyConfig['selectionMode']): string | undefined;
+export interface MetadataFieldPropertyDraft {
+    kind: MetadataFieldPropertyKind;
+    expectedBindingVersion?: number;
+    referenceConfig?: MetadataFieldReferencePropertyConfig;
+    dictionaryConfig?: MetadataFieldDictionaryPropertyConfig;
+}
+/** Relation-scoped property facts supplied by the module-governance read model. */
+export interface MetadataFieldPropertySummary extends MetadataFieldPropertyDraft {
+    fieldId?: string;
+    fieldName?: string;
+    fieldSpecAlias?: string;
+    bindingVersion?: number;
+    legacyReason?: string;
+    /** Transport shape of the relation-scoped property summary. */
+    reference?: MetadataFieldReferencePropertyConfig;
+    dictionary?: {
+        applicationAlias?: string;
+        categoryAlias?: string;
+        selectionMode?: 'SINGLE' | 'MULTIPLE';
+    };
+}
 export interface FieldSpecOption {
     value: string;
     label: string;
@@ -19,7 +65,7 @@ export declare function createMetadataOrchestrationState(): {
         moduleAlias?: string | undefined;
         metadataId?: string | undefined;
         relationAlias?: string | undefined;
-        relationRole?: "MAIN" | "CHILD" | undefined;
+        relationRole?: "main" | "child" | "MAIN" | "CHILD" | undefined;
         parentMetadataId?: string | undefined;
         foreignKey?: string | undefined;
         autoPopulate?: boolean | undefined;
@@ -38,7 +84,7 @@ export declare function createMetadataOrchestrationState(): {
         moduleAlias?: string | undefined;
         metadataId?: string | undefined;
         relationAlias?: string | undefined;
-        relationRole?: "MAIN" | "CHILD" | undefined;
+        relationRole?: "main" | "child" | "MAIN" | "CHILD" | undefined;
         parentMetadataId?: string | undefined;
         foreignKey?: string | undefined;
         autoPopulate?: boolean | undefined;
@@ -111,6 +157,61 @@ export declare function createMetadataOrchestrationState(): {
         updatedBy?: string | undefined;
         updatedAt?: string | undefined;
     }[]>;
+    allFields: import("vue").Ref<{
+        metadataId?: string | undefined;
+        fieldName?: string | undefined;
+        columnName?: string | undefined;
+        fieldSpecAlias?: string | undefined;
+        fieldOwnership?: string | undefined;
+        fieldForm?: string | undefined;
+        ownerFieldId?: string | undefined;
+        fieldRole?: string | undefined;
+        systemManaged?: boolean | undefined;
+        required?: boolean | undefined;
+        uniqueField?: boolean | undefined;
+        indexed?: boolean | undefined;
+        sortableField?: boolean | undefined;
+        titleField?: boolean | undefined;
+        enabled?: boolean | undefined;
+        sortOrder?: number | undefined;
+        title?: string | undefined;
+        id?: string | undefined;
+        tenantId?: string | undefined;
+        version?: number | undefined;
+        deleted?: boolean | undefined;
+        deletedAt?: string | undefined;
+        createdBy?: string | undefined;
+        createdAt?: string | undefined;
+        updatedBy?: string | undefined;
+        updatedAt?: string | undefined;
+    }[], MetadataField[] | {
+        metadataId?: string | undefined;
+        fieldName?: string | undefined;
+        columnName?: string | undefined;
+        fieldSpecAlias?: string | undefined;
+        fieldOwnership?: string | undefined;
+        fieldForm?: string | undefined;
+        ownerFieldId?: string | undefined;
+        fieldRole?: string | undefined;
+        systemManaged?: boolean | undefined;
+        required?: boolean | undefined;
+        uniqueField?: boolean | undefined;
+        indexed?: boolean | undefined;
+        sortableField?: boolean | undefined;
+        titleField?: boolean | undefined;
+        enabled?: boolean | undefined;
+        sortOrder?: number | undefined;
+        title?: string | undefined;
+        id?: string | undefined;
+        tenantId?: string | undefined;
+        version?: number | undefined;
+        deleted?: boolean | undefined;
+        deletedAt?: string | undefined;
+        createdBy?: string | undefined;
+        createdAt?: string | undefined;
+        updatedBy?: string | undefined;
+        updatedAt?: string | undefined;
+    }[]>;
     fieldSpecs: import("vue").Ref<{
         alias?: string | undefined;
         fieldType?: string | undefined;
@@ -121,6 +222,7 @@ export declare function createMetadataOrchestrationState(): {
         queryOperators?: string[] | undefined;
         defaultUiControlAlias?: string | undefined;
         uiControlAliases?: string[] | undefined;
+        safeTargetFieldSpecAliases?: string[] | undefined;
         enabled?: boolean | undefined;
         sortOrder?: number | undefined;
         title?: string | undefined;
@@ -143,6 +245,7 @@ export declare function createMetadataOrchestrationState(): {
         queryOperators?: string[] | undefined;
         defaultUiControlAlias?: string | undefined;
         uiControlAliases?: string[] | undefined;
+        safeTargetFieldSpecAliases?: string[] | undefined;
         enabled?: boolean | undefined;
         sortOrder?: number | undefined;
         title?: string | undefined;
@@ -225,11 +328,46 @@ export declare function createMetadataOrchestrationState(): {
         updatedBy?: string | undefined;
         updatedAt?: string | undefined;
     }>;
+    fieldPropertyDraft: import("vue").Ref<{
+        kind: MetadataFieldPropertyKind;
+        expectedBindingVersion?: number | undefined;
+        referenceConfig?: {
+            targetModuleAlias?: string | undefined;
+            targetMetadataId?: string | undefined;
+            targetKeyField?: string | undefined;
+            targetLabelField?: string | undefined;
+            cardinality?: "ONE" | "MANY" | undefined;
+            targetUnavailablePolicy?: "PRESERVE_HISTORY" | "RESTRICT" | "CASCADE_DELETE" | undefined;
+            projectionMappings?: string[] | undefined;
+        } | undefined;
+        dictionaryConfig?: {
+            dictionaryApplicationAlias?: string | undefined;
+            dictionaryCategoryAlias?: string | undefined;
+            selectionMode?: "SINGLE" | "MULTIPLE" | undefined;
+        } | undefined;
+    }, MetadataFieldPropertyDraft | {
+        kind: MetadataFieldPropertyKind;
+        expectedBindingVersion?: number | undefined;
+        referenceConfig?: {
+            targetModuleAlias?: string | undefined;
+            targetMetadataId?: string | undefined;
+            targetKeyField?: string | undefined;
+            targetLabelField?: string | undefined;
+            cardinality?: "ONE" | "MANY" | undefined;
+            targetUnavailablePolicy?: "PRESERVE_HISTORY" | "RESTRICT" | "CASCADE_DELETE" | undefined;
+            projectionMappings?: string[] | undefined;
+        } | undefined;
+        dictionaryConfig?: {
+            dictionaryApplicationAlias?: string | undefined;
+            dictionaryCategoryAlias?: string | undefined;
+            selectionMode?: "SINGLE" | "MULTIPLE" | undefined;
+        } | undefined;
+    }>;
     selectedRelation: import("vue").ComputedRef<{
         moduleAlias?: string | undefined;
         metadataId?: string | undefined;
         relationAlias?: string | undefined;
-        relationRole?: "MAIN" | "CHILD" | undefined;
+        relationRole?: "main" | "child" | "MAIN" | "CHILD" | undefined;
         parentMetadataId?: string | undefined;
         foreignKey?: string | undefined;
         autoPopulate?: boolean | undefined;
@@ -257,8 +395,9 @@ export declare function createMetadataOrchestrationState(): {
     selectRelation: (relation: ModuleMetadataRelation) => boolean;
     focusRelation: (relationId: string | undefined) => void;
     startCreateMain: () => void;
-    startCreateField: () => void;
-    startEditField: (field: MetadataField) => void;
+    startCreateField: (kind?: MetadataFieldPropertyKind) => void;
+    startEditField: (field: MetadataField, property?: MetadataFieldPropertyDraft) => void;
+    startConfigureFieldProperty: (field: MetadataField, kind: Exclude<MetadataFieldPropertyKind, "BASIC" | "LEGACY_LOCKED">) => void;
     cancelEditor: () => void;
 };
 export type MetadataOrchestrationState = ReturnType<typeof createMetadataOrchestrationState>;
@@ -266,13 +405,29 @@ export declare function emptyMainMetadataDraft(): MainMetadataDraft;
 export declare function normalizeMainMetadataDraft(draft: MainMetadataDraft): MainMetadataDraft;
 export declare function isValidMainMetadataDraft(draft: MainMetadataDraft): boolean;
 export declare function emptyFieldDraft(): MetadataFieldDraft;
+export declare function emptyFieldPropertyDraft(kind: MetadataFieldPropertyKind): MetadataFieldPropertyDraft;
+export declare function copyFieldPropertyDraft(property: MetadataFieldPropertyDraft): MetadataFieldPropertyDraft;
+/** Converts the read-model's concise bindings into the draft contract accepted by change sets. */
+export declare function propertyDraftFromSummary(summary: MetadataFieldPropertySummary): MetadataFieldPropertyDraft;
 export declare function copyMetadataField(field: MetadataField): MetadataFieldDraft;
 export declare function isValidFieldDraft(draft: MetadataFieldDraft): boolean;
 export declare function normalizeFieldDraft(draft: MetadataFieldDraft): MetadataFieldDraft;
+export declare function normalizeFieldPropertyDraft(property: MetadataFieldPropertyDraft): MetadataFieldPropertyDraft;
+export declare function isValidFieldPropertyDraft(property: MetadataFieldPropertyDraft): boolean;
+export declare function metadataFieldPropertyLabel(kind: MetadataFieldPropertyKind): string;
+export declare function metadataFieldPropertySummary(property: MetadataFieldPropertyDraft): string;
 /** Only business-owned physical fields are orchestrated; platform-managed fields stay hidden. */
 export declare function orchestratableFields(fields: MetadataField[]): MetadataField[];
+/** Only these field facts may be changed through the metadata field editor. */
+export declare function isOrchestratableField(field: MetadataField): boolean;
 export declare function fieldSpecOptionListOf(specs: FieldSpec[]): FieldSpecOption[];
+/** Filters a populated entity to the source specification's server-declared safe targets. */
+export declare function dataSafeFieldSpecOptions(specs: FieldSpec[], currentAlias?: string): FieldSpecOption[];
+/** Use the catalog title for human-facing metadata surfaces; aliases remain stable machine identities. */
+export declare function fieldSpecDisplayLabel(fieldSpecAlias: string | undefined, specs: FieldSpec[]): string;
 export declare function entityTitleOf(relation: ModuleMetadataRelation, metadata: Metadata | undefined): string;
 export declare function relationRoleTag(role: ModuleMetadataRelation['relationRole']): string | undefined;
+/** Java code enums are serialized by their stable lower-case code in runtime responses. */
+export declare function isMainRelation(role: ModuleMetadataRelation['relationRole'] | undefined): boolean;
 export declare function entityExplorerItem(relation: ModuleMetadataRelation, metadata: Metadata | undefined): RecordExplorerItemDescriptor;
 export declare function metadataSubtitleOf(metadata: Metadata | undefined): string | undefined;

package/dist/types/views/metadataSourceTree.d.ts

@@ -0,0 +1,10 @@
+import type { UiTreeNode } from '../vue-ui-antdv/index';
+/** Shared metadata presentation; consumers supply actions and capability restrictions. */
+export declare function metadataSourceFieldNode(field: {
+    title: string;
+    fieldName: string;
+    platformReadOnly?: boolean;
+    referenceModuleAlias?: string;
+    expandable?: boolean;
+}, options: Pick<UiTreeNode, 'key'> & Partial<UiTreeNode>): UiTreeNode;
+export declare function metadataSourceRoot(title: string, children: UiTreeNode[]): UiTreeNode;

package/dist/types/views/moduleGovernanceWorkspaceView.d.ts

@@ -0,0 +1,9 @@
+export declare const moduleGovernanceTabs: readonly ["overview", "metadata", "actions", "rules", "ui", "preview"];
+export type ModuleGovernanceTab = (typeof moduleGovernanceTabs)[number];
+export interface ModuleGovernanceWorkspaceViewInput {
+    moduleAlias: string;
+    moduleTitle?: string;
+    governanceTab?: ModuleGovernanceTab;
+}
+/** The module-scoped home for configuration governance surfaces. */
+export declare const moduleGovernanceWorkspaceView: import("../platform-workbench/workspaceViewContract.ts").WorkspaceViewDefinition<ModuleGovernanceWorkspaceViewInput>;

package/dist/types/views/pageCompositionDraftState.d.ts

@@ -0,0 +1,375 @@
+export type PageComposerSlot = 'list' | 'form';
+/** Runtime states, not independent configuration slots.  management v1 still owns only list/form. */
+export type PageComposerPreviewMode = 'list' | 'query' | 'detail' | 'edit';
+export interface PageComposerField {
+    id: string;
+    title: string;
+    fieldName: string;
+    /** Editor-only source diagnostic; never serialized into the page declaration. */
+    unavailable?: boolean;
+    fieldSpecAlias?: string;
+    required?: boolean;
+    /** Source visibility only; never serialized into the page declaration. */
+    systemManaged?: boolean;
+    platformReadOnly?: boolean;
+    referenceModuleAlias?: string;
+    /** A derived path through a ONE reference is display-only by platform contract. */
+    referenceCardinality?: 'ONE' | 'MANY';
+    expandable?: boolean;
+    /** Page-node presentation only; metadata field facts are never copied or edited here. */
+    properties?: PageComposerFieldProperties;
+}
+export interface PageComposerFieldProperties {
+    label?: string;
+    width?: string;
+    align?: 'left' | 'center' | 'right';
+    columnSpan?: 1 | 2;
+    readOnly?: boolean;
+}
+export type PageQuerySummarySource = 'MATCHED_COUNT' | 'SUM' | 'CONTRIBUTOR' | 'GROUPED';
+/** A list footer aggregate. Keys are editor-generated and stable across title changes. */
+export interface PageQuerySummary {
+    key: string;
+    label: string;
+    source: PageQuerySummarySource;
+    fieldName?: string;
+    contributorKey?: string;
+    groupByField?: string;
+}
+/** The catalogue is presentation-only source data; it is never persisted into the page draft. */
+export interface PageQuerySummaryCatalogTitles {
+    fields?: ReadonlyArray<{
+        fieldName: string;
+        title: string;
+    }>;
+    contributors?: ReadonlyArray<{
+        contributorKey: string;
+        title: string;
+    }>;
+    groupFields?: ReadonlyArray<{
+        fieldName: string;
+        title: string;
+    }>;
+}
+/** A concise, business-facing explanation for the tree and the summary editor. */
+export declare function pageQuerySummaryDescription(summary: PageQuerySummary, catalog?: PageQuerySummaryCatalogTitles): string;
+/** Default titles follow a user-selected source while a custom title remains the user's intent. */
+export declare function defaultPageQuerySummaryLabel(summary: PageQuerySummary, catalog?: PageQuerySummaryCatalogTitles): string;
+export declare function hasDefaultPageQuerySummaryLabel(summary: PageQuerySummary, catalog?: PageQuerySummaryCatalogTitles): boolean;
+/** A direct child relation placed as an association-list component in the detail slot. */
+export interface PageComposerRelation {
+    id: string;
+    relationCode: string;
+    unavailable?: boolean;
+    title: string;
+    /** The child-list projection is explicit: unplaced child fields do not appear at runtime. */
+    fields: PageComposerField[];
+}
+/** A standard runtime FormGroup: only its explicitly placed fields are rendered inside it. */
+export interface PageComposerGroup {
+    id: string;
+    groupCode: string;
+    title: string;
+    subtitle?: string;
+    fields: PageComposerField[];
+}
+export interface PageComposerNode {
+    id: string;
+    kind: 'slot' | 'template' | 'field' | 'group' | 'groupField' | 'relation' | 'relationField';
+    title: string;
+    slot: PageComposerSlot;
+    field?: PageComposerField;
+    relation?: PageComposerRelation;
+    relationField?: PageComposerField;
+    group?: PageComposerGroup;
+}
+export type PageComposerFormItem = {
+    kind: 'field' | 'group';
+    id: string;
+};
+export type ManagementFormOrder = Array<{
+    field: string;
+} | {
+    group: string;
+}>;
+/** Complete order, with legacy drafts defaulting to fields followed by groups. */
+export declare function orderedFormItems(form: PageComposerField[], groups: PageComposerGroup[], order?: PageComposerFormItem[]): PageComposerFormItem[];
+export interface ManagementUiTree {
+    template: 'management';
+    templateVersion: 1;
+    props?: {
+        list?: {
+            searchPlaceholder: string;
+        };
+    };
+    querySummaries?: PageQuerySummary[];
+    nodes: Array<{
+        slot: PageComposerSlot;
+        title: string;
+        fields: Array<string | {
+            field: string;
+            props: PageComposerFieldProperties;
+        }>;
+        order?: ManagementFormOrder;
+        relations?: Array<{
+            relation: string;
+            title: string;
+            fields?: Array<string | {
+                field: string;
+                props: PageComposerFieldProperties;
+            }>;
+        }>;
+        groups?: Array<{
+            group: string;
+            title: string;
+            subtitle?: string;
+            fields: Array<string | {
+                field: string;
+                props: PageComposerFieldProperties;
+            }>;
+        }>;
+    }>;
+}
+/**
+ * The editor deliberately owns a small, serialisable draft. It is the
+ * PageDefinition / PresentationRevision editing model rather than a
+ * projection of another configuration aggregate.
+ */
+export declare function createPageCompositionDraftState(): {
+    listFields: import("vue").Ref<{
+        id: string;
+        title: string;
+        fieldName: string;
+        unavailable?: boolean | undefined;
+        fieldSpecAlias?: string | undefined;
+        required?: boolean | undefined;
+        systemManaged?: boolean | undefined;
+        platformReadOnly?: boolean | undefined;
+        referenceModuleAlias?: string | undefined;
+        referenceCardinality?: "ONE" | "MANY" | undefined;
+        expandable?: boolean | undefined;
+        properties?: {
+            label?: string | undefined;
+            width?: string | undefined;
+            align?: "left" | "center" | "right" | undefined;
+            columnSpan?: 1 | 2 | undefined;
+            readOnly?: boolean | undefined;
+        } | undefined;
+    }[], PageComposerField[] | {
+        id: string;
+        title: string;
+        fieldName: string;
+        unavailable?: boolean | undefined;
+        fieldSpecAlias?: string | undefined;
+        required?: boolean | undefined;
+        systemManaged?: boolean | undefined;
+        platformReadOnly?: boolean | undefined;
+        referenceModuleAlias?: string | undefined;
+        referenceCardinality?: "ONE" | "MANY" | undefined;
+        expandable?: boolean | undefined;
+        properties?: {
+            label?: string | undefined;
+            width?: string | undefined;
+            align?: "left" | "center" | "right" | undefined;
+            columnSpan?: 1 | 2 | undefined;
+            readOnly?: boolean | undefined;
+        } | undefined;
+    }[]>;
+    formFields: import("vue").Ref<{
+        id: string;
+        title: string;
+        fieldName: string;
+        unavailable?: boolean | undefined;
+        fieldSpecAlias?: string | undefined;
+        required?: boolean | undefined;
+        systemManaged?: boolean | undefined;
+        platformReadOnly?: boolean | undefined;
+        referenceModuleAlias?: string | undefined;
+        referenceCardinality?: "ONE" | "MANY" | undefined;
+        expandable?: boolean | undefined;
+        properties?: {
+            label?: string | undefined;
+            width?: string | undefined;
+            align?: "left" | "center" | "right" | undefined;
+            columnSpan?: 1 | 2 | undefined;
+            readOnly?: boolean | undefined;
+        } | undefined;
+    }[], PageComposerField[] | {
+        id: string;
+        title: string;
+        fieldName: string;
+        unavailable?: boolean | undefined;
+        fieldSpecAlias?: string | undefined;
+        required?: boolean | undefined;
+        systemManaged?: boolean | undefined;
+        platformReadOnly?: boolean | undefined;
+        referenceModuleAlias?: string | undefined;
+        referenceCardinality?: "ONE" | "MANY" | undefined;
+        expandable?: boolean | undefined;
+        properties?: {
+            label?: string | undefined;
+            width?: string | undefined;
+            align?: "left" | "center" | "right" | undefined;
+            columnSpan?: 1 | 2 | undefined;
+            readOnly?: boolean | undefined;
+        } | undefined;
+    }[]>;
+    formRelations: import("vue").Ref<{
+        id: string;
+        relationCode: string;
+        unavailable?: boolean | undefined;
+        title: string;
+        fields: {
+            id: string;
+            title: string;
+            fieldName: string;
+            unavailable?: boolean | undefined;
+            fieldSpecAlias?: string | undefined;
+            required?: boolean | undefined;
+            systemManaged?: boolean | undefined;
+            platformReadOnly?: boolean | undefined;
+            referenceModuleAlias?: string | undefined;
+            referenceCardinality?: "ONE" | "MANY" | undefined;
+            expandable?: boolean | undefined;
+            properties?: {
+                label?: string | undefined;
+                width?: string | undefined;
+                align?: "left" | "center" | "right" | undefined;
+                columnSpan?: 1 | 2 | undefined;
+                readOnly?: boolean | undefined;
+            } | undefined;
+        }[];
+    }[], PageComposerRelation[] | {
+        id: string;
+        relationCode: string;
+        unavailable?: boolean | undefined;
+        title: string;
+        fields: {
+            id: string;
+            title: string;
+            fieldName: string;
+            unavailable?: boolean | undefined;
+            fieldSpecAlias?: string | undefined;
+            required?: boolean | undefined;
+            systemManaged?: boolean | undefined;
+            platformReadOnly?: boolean | undefined;
+            referenceModuleAlias?: string | undefined;
+            referenceCardinality?: "ONE" | "MANY" | undefined;
+            expandable?: boolean | undefined;
+            properties?: {
+                label?: string | undefined;
+                width?: string | undefined;
+                align?: "left" | "center" | "right" | undefined;
+                columnSpan?: 1 | 2 | undefined;
+                readOnly?: boolean | undefined;
+            } | undefined;
+        }[];
+    }[]>;
+    formGroups: import("vue").Ref<{
+        id: string;
+        groupCode: string;
+        title: string;
+        subtitle?: string | undefined;
+        fields: {
+            id: string;
+            title: string;
+            fieldName: string;
+            unavailable?: boolean | undefined;
+            fieldSpecAlias?: string | undefined;
+            required?: boolean | undefined;
+            systemManaged?: boolean | undefined;
+            platformReadOnly?: boolean | undefined;
+            referenceModuleAlias?: string | undefined;
+            referenceCardinality?: "ONE" | "MANY" | undefined;
+            expandable?: boolean | undefined;
+            properties?: {
+                label?: string | undefined;
+                width?: string | undefined;
+                align?: "left" | "center" | "right" | undefined;
+                columnSpan?: 1 | 2 | undefined;
+                readOnly?: boolean | undefined;
+            } | undefined;
+        }[];
+    }[], PageComposerGroup[] | {
+        id: string;
+        groupCode: string;
+        title: string;
+        subtitle?: string | undefined;
+        fields: {
+            id: string;
+            title: string;
+            fieldName: string;
+            unavailable?: boolean | undefined;
+            fieldSpecAlias?: string | undefined;
+            required?: boolean | undefined;
+            systemManaged?: boolean | undefined;
+            platformReadOnly?: boolean | undefined;
+            referenceModuleAlias?: string | undefined;
+            referenceCardinality?: "ONE" | "MANY" | undefined;
+            expandable?: boolean | undefined;
+            properties?: {
+                label?: string | undefined;
+                width?: string | undefined;
+                align?: "left" | "center" | "right" | undefined;
+                columnSpan?: 1 | 2 | undefined;
+                readOnly?: boolean | undefined;
+            } | undefined;
+        }[];
+    }[]>;
+    formOrder: import("vue").Ref<{
+        kind: "field" | "group";
+        id: string;
+    }[], PageComposerFormItem[] | {
+        kind: "field" | "group";
+        id: string;
+    }[]>;
+    querySummaries: import("vue").Ref<{
+        key: string;
+        label: string;
+        source: PageQuerySummarySource;
+        fieldName?: string | undefined;
+        contributorKey?: string | undefined;
+        groupByField?: string | undefined;
+    }[], PageQuerySummary[] | {
+        key: string;
+        label: string;
+        source: PageQuerySummarySource;
+        fieldName?: string | undefined;
+        contributorKey?: string | undefined;
+        groupByField?: string | undefined;
+    }[]>;
+    orderedForm: import("vue").ComputedRef<PageComposerFormItem[]>;
+    quickSearchPlaceholder: import("vue").Ref<string | undefined, string | undefined>;
+    nodes: import("vue").ComputedRef<PageComposerNode[]>;
+    selectedNodeId: import("vue").Ref<string | undefined, string | undefined>;
+    selectedNode: import("vue").ComputedRef<PageComposerNode | undefined>;
+    previewMode: import("vue").Ref<PageComposerPreviewMode, PageComposerPreviewMode>;
+    addField: (field: PageComposerField, slot?: PageComposerSlot, targetIndex?: number) => void;
+    addFormRelation: (relation: PageComposerRelation) => void;
+    addFormGroup: () => void;
+    moveFormFieldToGroup: (fieldId: string, groupId: string, targetIndex?: number) => void;
+    moveGroupFieldToForm: (groupId: string, fieldId: string, targetIndex?: number) => void;
+    moveGroupField: (groupId: string, fieldId: string, targetIndex?: number) => void;
+    moveGroupFieldToGroup: (sourceGroupId: string, fieldId: string, targetGroupId: string, targetIndex?: number) => void;
+    updateFormGroup: (groupId: string, title: string, subtitle?: string) => void;
+    moveFormGroup: (groupId: string, targetIndex?: number) => void;
+    moveFormRelation: (relationId: string, targetIndex: number) => void;
+    addFormRelationField: (relation: PageComposerRelation, field: PageComposerField) => void;
+    moveFormRelationField: (relationId: string, fieldId: string, targetIndex?: number) => void;
+    removeSelectedField: () => void;
+    moveSelectedField: (offset: -1 | 1) => void;
+    moveField: (fieldId: string, from: PageComposerSlot, to: PageComposerSlot, targetIndex?: number) => void;
+    selectNode: (node: PageComposerNode) => void;
+    updateSelectedFieldProperties: (properties: PageComposerFieldProperties) => void;
+    updateQuickSearchPlaceholder: (value: string | undefined) => void;
+    replaceQuerySummaries: (summaries: readonly PageQuerySummary[]) => void;
+    replaceFields: (next: {
+        list: PageComposerField[];
+        form: PageComposerField[];
+        relations?: PageComposerRelation[];
+        groups?: PageComposerGroup[];
+        order?: PageComposerFormItem[];
+    }) => void;
+    normalizeFormFieldPlacements: () => boolean;
+    toManagementUiTree: (titles?: Partial<Record<PageComposerSlot, string>>) => ManagementUiTree;
+};

package/dist/types/views/pageCompositionDragPayload.d.ts

@@ -0,0 +1,26 @@
+export declare const PAGE_COMPOSITION_DRAG_PAYLOAD_TYPE = "application/x-muyun-page-composer";
+export type MetadataDragPayload = {
+    kind: 'field';
+    fieldId: string;
+    /** Ephemeral preview facts; placement persistence still resolves by fieldId only. */
+    fieldName?: string;
+    title?: string;
+    fieldSpecAlias?: string;
+    required?: boolean;
+    readOnly?: boolean;
+} | {
+    kind: 'relation';
+    relationId: string;
+} | {
+    kind: 'relationField';
+    relationId: string;
+    fieldId: string;
+};
+/** A module action is a source fact, distinct from metadata fields and relations. */
+export type ModuleActionDragPayload = {
+    kind: 'action';
+    actionCode: string;
+};
+export type PageCompositionDragPayload = MetadataDragPayload | ModuleActionDragPayload;
+export declare function parseMetadataDragPayload(payload: unknown): MetadataDragPayload | undefined;
+export declare function parsePageCompositionDragPayload(payload: unknown): PageCompositionDragPayload | undefined;