@ximatai/muyun-web-app 0.26.12 → 0.26.13

package/dist/types/platform-components/RecordModeDrawer.vue.d.ts

@@ -1,18 +1,23 @@
-import { type UiSidePanelScope } from '../vue-ui-antdv/index';
+import { type UiDrawerCloseGuard, type UiDrawerDismissal, type UiDrawerWidth, type UiSidePanelScope } from '../vue-ui-antdv/index';
 import type { DrawerPromotion } from './drawerPromotion';
 type __VLS_Props = {
     open: boolean;
     title: string;
     container?: HTMLElement | null;
+    /** Explicit presentation is needed by embedded record-only surfaces. */
+    renderMode?: 'inline' | 'portal';
     subtitle?: string;
-    width?: number | string;
+    width?: UiDrawerWidth;
     scope?: UiSidePanelScope;
     mode: string;
     viewMode?: string;
     formModes?: string[];
     loading?: boolean;
     loadFailed?: boolean;
+    dismissal?: UiDrawerDismissal;
+    /** @deprecated Use `dismissal` and `beforeClose`. */
     closeOnOutside?: boolean;
+    beforeClose?: UiDrawerCloseGuard;
     closeTitle?: string;
     promotion?: DrawerPromotion;
     errorTitle?: string;
@@ -61,11 +66,14 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onDismissExternalChange?: (() => any) | undefined;
 }>, {
     scope: UiSidePanelScope;
-    width: number | string;
+    width: UiDrawerWidth;
     loading: boolean;
     subtitle: string;
+    dismissal: UiDrawerDismissal;
     closeOnOutside: boolean;
+    beforeClose: UiDrawerCloseGuard;
     container: HTMLElement | null;
+    renderMode: "inline" | "portal";
     closeTitle: string;
     promotion: DrawerPromotion;
     errorTitle: string;

package/dist/types/platform-components/RecordMultiPicker.vue.d.ts

@@ -8,7 +8,7 @@ type __VLS_Props = {
     loadTree?: () => Promise<WebTreeNode<RecordPickerRecord>[]>;
     resolveOptions?: (values: string[]) => Promise<RecordPickerRecord[]>;
     value?: string[];
-    reloadKey?: number;
+    reloadKey?: string | number;
     mode?: RecordPickerMode;
     placeholder?: string;
     disabled?: boolean;
@@ -31,7 +31,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     placeholder: string;
     allowClear: boolean;
     filterOption: (record: RecordPickerRecord, keyword: string) => boolean;
-    reloadKey: number;
+    reloadKey: string | number;
     titleOf: (record: RecordPickerRecord) => string;
     loadOptions: (keyword: string) => Promise<RecordPickerRecord[]>;
     loadTree: () => Promise<WebTreeNode<RecordPickerRecord>[]>;

package/dist/types/platform-components/RecordPicker.vue.d.ts

@@ -8,7 +8,7 @@ type __VLS_Props = {
     loadTree?: () => Promise<WebTreeNode<RecordPickerRecord>[]>;
     resolveOptions?: (values: string[]) => Promise<RecordPickerRecord[]>;
     value?: string;
-    reloadKey?: number;
+    reloadKey?: string | number;
     mode?: RecordPickerMode;
     placeholder?: string;
     disabled?: boolean;
@@ -33,7 +33,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
     placeholder: string;
     allowClear: boolean;
     filterOption: (record: RecordPickerRecord, keyword: string) => boolean;
-    reloadKey: number;
+    reloadKey: string | number;
     titleOf: (record: RecordPickerRecord) => string;
     loadOptions: (keyword: string) => Promise<RecordPickerRecord[]>;
     loadTree: () => Promise<WebTreeNode<RecordPickerRecord>[]>;

package/dist/types/platform-components/RecordQueryListPanel.vue.d.ts

@@ -1,5 +1,6 @@
-import type { QuerySchema, ResolvedPageListPersistentQueryControlDescriptor, ResolvedPageListQuerySummaryDescriptor } from '../web-contracts/index';
+import type { QuerySchema, QuerySchemaField, ResolvedPageListPersistentQueryControlDescriptor, WebQueryRequest, ResolvedPageListQuerySummaryDescriptor } from '../web-contracts/index';
 import { type ModuleContext } from '../web-core/index';
+import type { ReferencePickerConfig } from './referencePickerModel';
 import { type RecordActionItem, type ResolvedRecordActionItem } from './recordActionBarModel';
 import { type QueryListRecord, type RecordQueryListCellComponent, type RecordQueryListColumn, type RecordQueryListMode, type StandardCrudRowActionKey } from './recordQueryListColumnModel';
 export type { QueryListRecord, RecordQueryListCellComponent, RecordQueryListColumn, RecordQueryListMode, StandardCrudRowActionKey, } from './recordQueryListColumnModel';
@@ -56,10 +57,14 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     queryTemplateId?: string;
     /** A source-owned query schema avoids forcing embedded relation lists through target-module access. */
     querySchema?: QuerySchema;
+    /** Allows a source surface to supply semantic user candidates for a query field. */
+    referencePickerOf?: (field: QuerySchemaField) => ReferencePickerConfig | undefined;
     /** Read-only relation runners may deliberately suppress ad-hoc query controls. */
     queryable?: boolean;
     /** A relation query can intentionally be a bounded, non-pageable result. */
     pageable?: boolean;
+    /** Opts a standard, paginated flat list into the platform's relative sort interaction. */
+    sortable?: boolean;
     ready?: boolean;
     externalQueryValues?: Record<string, unknown>;
     /** Descriptor-owned controls rendered after quick search and before advanced filtering. */
@@ -83,9 +88,11 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     rowExpand: (record: QueryListRecord, expanded: boolean) => any;
     restored: () => any;
     pageSizeChange: (pageSize: number) => any;
+    recordActivate: (record: QueryListRecord, event: MouseEvent) => any;
     batchAction: (action: RecordActionItem, records: QueryListRecord[], event: MouseEvent, clearSelection: () => void) => any;
     rowAction: (action: ResolvedRecordActionItem, record: QueryListRecord, event?: MouseEvent | undefined) => any;
     modeChange: (mode: RecordQueryListMode) => any;
+    queried: (request: WebQueryRequest) => any;
 }, string, import("vue").PublicProps, Readonly<{
     context: ModuleContext<QueryListRecord>;
     title: string;
@@ -137,10 +144,14 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     queryTemplateId?: string;
     /** A source-owned query schema avoids forcing embedded relation lists through target-module access. */
     querySchema?: QuerySchema;
+    /** Allows a source surface to supply semantic user candidates for a query field. */
+    referencePickerOf?: (field: QuerySchemaField) => ReferencePickerConfig | undefined;
     /** Read-only relation runners may deliberately suppress ad-hoc query controls. */
     queryable?: boolean;
     /** A relation query can intentionally be a bounded, non-pageable result. */
     pageable?: boolean;
+    /** Opts a standard, paginated flat list into the platform's relative sort interaction. */
+    sortable?: boolean;
     ready?: boolean;
     externalQueryValues?: Record<string, unknown>;
     /** Descriptor-owned controls rendered after quick search and before advanced filtering. */
@@ -161,9 +172,11 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     onRowExpand?: ((record: QueryListRecord, expanded: boolean) => any) | undefined;
     onRestored?: (() => any) | undefined;
     onPageSizeChange?: ((pageSize: number) => any) | undefined;
+    onRecordActivate?: ((record: QueryListRecord, event: MouseEvent) => any) | undefined;
     onBatchAction?: ((action: RecordActionItem, records: QueryListRecord[], event: MouseEvent, clearSelection: () => void) => any) | undefined;
     onRowAction?: ((action: ResolvedRecordActionItem, record: QueryListRecord, event?: MouseEvent | undefined) => any) | undefined;
     onModeChange?: ((mode: RecordQueryListMode) => any) | undefined;
+    onQueried?: ((request: WebQueryRequest) => any) | undefined;
 }>, {
     uiConfigId: string;
     mode: RecordQueryListMode;
@@ -187,6 +200,9 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     embedded: boolean;
     pageable: boolean;
     cellRenderers: Record<string, (record: QueryListRecord) => string>;
+    refreshTitle: string;
+    refreshable: boolean;
+    referencePickerOf: (field: QuerySchemaField) => ReferencePickerConfig | undefined;
     additionalColumns: Array<RecordQueryListColumn & {
         before?: string;
         after?: string;
@@ -203,12 +219,10 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     rowActionStateOf: (record: QueryListRecord, action: RecordActionItem) => Partial<RecordActionItem> | undefined;
     rowActionsTitle: string;
     rowActionsVisible: boolean;
-    refreshTitle: string;
-    refreshable: boolean;
     showRecycleBin: boolean;
     querySchema: QuerySchema;
     queryable: boolean;
-    persistentQueryControls: ResolvedPageListPersistentQueryControlDescriptor[];
+    sortable: boolean;
     querySummaries: ResolvedPageListQuerySummaryDescriptor[];
     requiredExternalCriteriaKeys: string[];
     waitingDescription: string;

package/dist/types/platform-components/RecordQueryListSurface.vue.d.ts

@@ -25,12 +25,18 @@ type __VLS_Props = {
     actionColumnTitle?: string;
     actionColumnWidth?: string | number;
     actionColumnFixed?: boolean;
+    /** The list owner persists generic row-reorder events. */
+    rowDraggable?: boolean;
+    rowDragHandleTitle?: string;
     tableVisible?: boolean;
+    conditionsVisible?: boolean;
     embedded?: boolean;
     chromeFree?: boolean;
     /** The surface renders pagination only; its owner keeps query state and data loading. */
     pageable?: boolean;
     total?: number;
+    /** False when the backend exposes only a lower bound for cursor-backed pagination. */
+    totalKnown?: boolean;
     pageNum?: number;
     pages?: number;
     pageSize?: number;
@@ -65,6 +71,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     rowClick: (record: UiDataTableRecord, event: MouseEvent) => any;
     rowDblclick: (record: UiDataTableRecord, event: MouseEvent) => any;
     rowExpand: (record: UiDataTableRecord, expanded: boolean) => any;
+    rowDrop: (event: {
+        source: UiDataTableRecord;
+        target: UiDataTableRecord;
+        position: "before" | "after";
+    }) => any;
     quickSearch: (value: string) => any;
     titleAction: () => any;
     "update:quickSearchValue": (value: string) => any;
@@ -74,6 +85,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     onRowClick?: ((record: UiDataTableRecord, event: MouseEvent) => any) | undefined;
     onRowDblclick?: ((record: UiDataTableRecord, event: MouseEvent) => any) | undefined;
     onRowExpand?: ((record: UiDataTableRecord, expanded: boolean) => any) | undefined;
+    onRowDrop?: ((event: {
+        source: UiDataTableRecord;
+        target: UiDataTableRecord;
+        position: "before" | "after";
+    }) => any) | undefined;
     onQuickSearch?: ((value: string) => any) | undefined;
     onTitleAction?: (() => any) | undefined;
     "onUpdate:quickSearchValue"?: ((value: string) => any) | undefined;
@@ -94,6 +110,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     actionColumnTitle: string;
     actionColumnWidth: string | number;
     actionColumnFixed: boolean;
+    rowDraggable: boolean;
+    rowDragHandleTitle: string;
     total: number;
     pageSize: number;
     pageSizeOptions: number[];
@@ -108,9 +126,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     quickSearchPlaceholder: string;
     quickSearchDisabled: boolean;
     tableVisible: boolean;
+    conditionsVisible: boolean;
     embedded: boolean;
     chromeFree: boolean;
     pageable: boolean;
+    totalKnown: boolean;
     pages: number;
     paginationDisabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/types/platform-components/ReferencePicker.vue.d.ts

@@ -0,0 +1,47 @@
+import { type ReferencePickerCandidate, type ReferencePickerColumn, type ReferencePickerId, type ReferencePickerProvider, type ReferencePickerValidity } from './referencePickerModel';
+type __VLS_Props = {
+    value?: ReferencePickerId | readonly ReferencePickerId[];
+    multiple?: boolean;
+    maxSelection?: number;
+    provider: ReferencePickerProvider;
+    /** Changes in source dependencies or authorization must isolate all remembered candidates. */
+    reloadKey?: string | number;
+    mode?: 'dialog' | 'dropdown';
+    columns?: readonly ReferencePickerColumn[];
+    placeholder?: string;
+    disabled?: boolean;
+    allowClear?: boolean;
+    pageSize?: number;
+    title?: string;
+    searchPlaceholder?: string;
+    emptyDescription?: string;
+    selectionNoun?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (candidates: ReferencePickerCandidate[]) => any;
+    "update:value": (value: string | string[] | undefined) => any;
+    "selection-resolved": (candidates: ReferencePickerCandidate[]) => any;
+    "validity-change": (validity: ReferencePickerValidity) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((candidates: ReferencePickerCandidate[]) => any) | undefined;
+    "onUpdate:value"?: ((value: string | string[] | undefined) => any) | undefined;
+    "onSelection-resolved"?: ((candidates: ReferencePickerCandidate[]) => any) | undefined;
+    "onValidity-change"?: ((validity: ReferencePickerValidity) => any) | undefined;
+}>, {
+    title: string;
+    disabled: boolean;
+    mode: "dialog" | "dropdown";
+    value: ReferencePickerId | readonly ReferencePickerId[];
+    placeholder: string;
+    allowClear: boolean;
+    multiple: boolean;
+    reloadKey: string | number;
+    emptyDescription: string;
+    columns: readonly ReferencePickerColumn[];
+    pageSize: number;
+    searchPlaceholder: string;
+    maxSelection: number;
+    selectionNoun: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/platform-components/ReferenceRecordDetailBrowser.vue.d.ts

@@ -0,0 +1,55 @@
+import type { HttpClient } from '../web-core/index';
+import { type ReferenceRecordDetailMutation, type ReferenceRecordDetailBrowser as ReferenceRecordDetailBrowserState } from './referenceRecordDetailBrowser';
+type __VLS_Props = {
+    http?: HttpClient;
+    browser?: ReferenceRecordDetailBrowserState;
+    inlineAnchor?: boolean;
+};
+declare function reportMutation(mutation: ReferenceRecordDetailMutation): void;
+declare function setBusy(busy: boolean): void;
+declare var __VLS_1: {}, __VLS_3: {
+    active: import("./referenceRecordDetailBrowser").ActiveReferenceRecord | undefined;
+    context: import("../web-core/index").ModuleContext<import("./recordQueryListColumnModel.ts").QueryListRecord> | undefined;
+    record: import("./recordQueryListColumnModel.ts").QueryListRecord | undefined;
+    reportMutation: typeof reportMutation;
+    setBusy: typeof setBusy;
+    close: () => void;
+}, __VLS_14: {
+    context: import("../web-core/index").ModuleContext<import("./recordQueryListColumnModel.ts").QueryListRecord> | undefined;
+    record: import("./recordQueryListColumnModel.ts").QueryListRecord | undefined;
+    reportMutation: typeof reportMutation;
+    setBusy: typeof setBusy;
+}, __VLS_31: {
+    context: import("../web-core/index").ModuleContext<import("./recordQueryListColumnModel.ts").QueryListRecord>;
+    record: import("./recordQueryListColumnModel.ts").QueryListRecord;
+    reportMutation: typeof reportMutation;
+    setBusy: typeof setBusy;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+} & {
+    'full-surface'?: (props: typeof __VLS_3) => any;
+} & {
+    'header-actions'?: (props: typeof __VLS_14) => any;
+} & {
+    detail?: (props: typeof __VLS_31) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    browser: ReferenceRecordDetailBrowserState;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "record-change": (mutation: ReferenceRecordDetailMutation) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onRecord-change"?: ((mutation: ReferenceRecordDetailMutation) => any) | undefined;
+}>, {
+    http: HttpClient;
+    browser: ReferenceRecordDetailBrowserState;
+    inlineAnchor: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/platform-components/ScopedTreePicker.vue.d.ts

@@ -0,0 +1,31 @@
+import { type ScopedTreePickerCandidate, type ScopedTreePickerProvider } from './scopedTreePickerModel';
+type __VLS_Props = {
+    /** The persisted target identity. The component never persists navigation scope IDs. */
+    value?: string;
+    provider: ScopedTreePickerProvider;
+    placeholder?: string;
+    searchPlaceholder?: string;
+    title?: string;
+    disabled?: boolean;
+    /** The host already renders its own compact trigger, so this component only contributes a dialog. */
+    inputHidden?: boolean;
+};
+declare function openPicker(value?: string): void;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    open: typeof openPicker;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (candidate: ScopedTreePickerCandidate | undefined) => any;
+    "update:value": (value: string | undefined) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((candidate: ScopedTreePickerCandidate | undefined) => any) | undefined;
+    "onUpdate:value"?: ((value: string | undefined) => any) | undefined;
+}>, {
+    title: string;
+    disabled: boolean;
+    value: string;
+    placeholder: string;
+    searchPlaceholder: string;
+    inputHidden: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/platform-components/UserPicker.vue.d.ts

@@ -0,0 +1,47 @@
+import type { ReferencePickerSourceIdentity, ReferencePickerValidity } from './referencePickerModel';
+import type { UserAccountId, UserPickerCandidate, UserPickerPageSearch, UserPickerResolver } from './userPickerModel';
+type __VLS_Props = {
+    value?: UserAccountId | readonly UserAccountId[];
+    multiple?: boolean;
+    maxSelection?: number;
+    placeholder?: string;
+    disabled?: boolean;
+    allowClear?: boolean;
+    pageSize?: number;
+    title?: string;
+    searchPlaceholder?: string;
+    emptyDescription?: string;
+    selectionNoun?: string;
+    reloadKey?: string | number;
+    /** A caller declares its source purpose; account target identity alone is never a cache scope. */
+    sourceIdentity?: ReferencePickerSourceIdentity;
+    searchPage: UserPickerPageSearch;
+    resolveUsers: UserPickerResolver;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (users: UserPickerCandidate[]) => any;
+    "update:value": (value: string | string[] | undefined) => any;
+    "selection-resolved": (users: UserPickerCandidate[]) => any;
+    "validity-change": (validity: ReferencePickerValidity) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((users: UserPickerCandidate[]) => any) | undefined;
+    "onUpdate:value"?: ((value: string | string[] | undefined) => any) | undefined;
+    "onSelection-resolved"?: ((users: UserPickerCandidate[]) => any) | undefined;
+    "onValidity-change"?: ((validity: ReferencePickerValidity) => any) | undefined;
+}>, {
+    title: string;
+    disabled: boolean;
+    value: UserAccountId | readonly UserAccountId[];
+    placeholder: string;
+    allowClear: boolean;
+    multiple: boolean;
+    reloadKey: string | number;
+    emptyDescription: string;
+    pageSize: number;
+    searchPlaceholder: string;
+    maxSelection: number;
+    selectionNoun: string;
+    sourceIdentity: ReferencePickerSourceIdentity;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/platform-components/dictionaryOptionDialogModel.d.ts

@@ -0,0 +1,23 @@
+import type { Option, OptionItemDescriptor } from '../web-contracts/index';
+export type DictionarySelectionMode = 'SINGLE' | 'MULTIPLE';
+export type DictionaryOptionValue = string | string[] | undefined;
+export interface DictionaryOptionTreeNode {
+    value: string;
+    title: string;
+    disabled?: boolean;
+    children?: DictionaryOptionTreeNode[];
+}
+/**
+ * Normalizes the persisted dictionary wire value. Dictionary values are always codes;
+ * titles are display facts and must never leak into the form draft.
+ */
+export declare function dictionaryOptionCodes(value: unknown, selectionMode: DictionarySelectionMode): string[];
+export declare function dictionaryOptionValue(codes: readonly string[], selectionMode: DictionarySelectionMode): DictionaryOptionValue;
+export declare function dictionaryOptionItemsToOptions(items: readonly OptionItemDescriptor[], keyword?: string): Option[];
+/**
+ * Retains the parent/child relationship carried by `parentCode`. Missing parents are rendered
+ * as an explicit disabled structural node instead of silently promoting their children to roots.
+ */
+export declare function dictionaryOptionItemsToTree(items: readonly OptionItemDescriptor[], keyword?: string): DictionaryOptionTreeNode[];
+/** Existing disabled values remain visible, but only enabled option codes can be newly added. */
+export declare function selectableDictionaryCodes(requested: unknown, externalCodes: readonly string[], items: readonly OptionItemDescriptor[], selectionMode: DictionarySelectionMode): string[];

package/dist/types/platform-components/employeePickerModel.d.ts

@@ -0,0 +1,19 @@
+import type { IdentityPickerCandidate, IdentityPickerPage, IdentityPickerPageRequest, IdentityPickerPageSearch, IdentityPickerResolver } from './identityPickerModel';
+/** A personnel master-data identity; it is intentionally distinct from a user account ID. */
+export type EmployeeId = string;
+export type EmployeePickerCandidate = IdentityPickerCandidate<EmployeeId>;
+export type EmployeePickerPageRequest = IdentityPickerPageRequest;
+export type EmployeePickerPage = IdentityPickerPage<EmployeeId>;
+export type EmployeePickerPageSearch = IdentityPickerPageSearch<EmployeeId>;
+export type EmployeePickerResolver = IdentityPickerResolver<EmployeeId>;
+/**
+ * Source-owned employee delivery. Callers supply the authorized candidate
+ * scope; this UI boundary does not read IAM modules or infer tenant scope.
+ */
+export interface EmployeePickerConfig {
+    title?: string;
+    placeholder?: string;
+    maxSelection?: number;
+    searchPage: EmployeePickerPageSearch;
+    resolveEmployees: EmployeePickerResolver;
+}

package/dist/types/platform-components/identityPickerModel.d.ts

@@ -0,0 +1,18 @@
+import type { ReferencePickerCandidate } from './referencePickerModel';
+/** Identity aliases retain their distinct IDs while using the common display contract. */
+export interface IdentityPickerCandidate<TId extends string> extends ReferencePickerCandidate {
+    id: TId;
+}
+export interface IdentityPickerPageRequest {
+    /** Provider-defined search text. The shared panel does not prescribe searchable fields. */
+    keyword: string;
+    pageNum: number;
+    pageSize: number;
+}
+export interface IdentityPickerPage<TId extends string> {
+    records: IdentityPickerCandidate<TId>[];
+    total: number;
+}
+export type IdentityPickerPageSearch<TId extends string> = (request: IdentityPickerPageRequest) => Promise<IdentityPickerPage<TId>>;
+/** Resolves persisted IDs through the same authorized candidate scope as the page search. */
+export type IdentityPickerResolver<TId extends string> = (ids: TId[]) => Promise<IdentityPickerCandidate<TId>[]>;

package/dist/types/platform-components/index.d.ts

@@ -5,6 +5,8 @@ export { default as ApplicationScopeSwitcher } from './ApplicationScopeSwitcher.
 export { default as BusinessNotificationPanel } from './BusinessNotificationPanel.vue';
 export { confirmAction } from '../vue-ui-antdv/index';
 export { UiModal } from '../vue-ui-antdv/index';
+export { uiDrawerWidths as drawerWidths } from '../vue-ui-antdv/index';
+export type { UiDrawerWidth as DrawerWidth } from '../vue-ui-antdv/index';
 export { default as CrudRecordListExplorer } from './CrudRecordListExplorer.vue';
 export { default as DrawerOperationBar } from './DrawerOperationBar.vue';
 export { default as DrawerTitleActions } from './DrawerTitleActions.vue';
@@ -32,6 +34,10 @@ export type { HeaderActionItem } from './AdaptiveHeaderActionBar.vue';
 export type { HeaderActionLevel } from './adaptiveHeaderActionLayout';
 export { default as RecordContentSectionHeading } from './RecordContentSectionHeading.vue';
 export { default as RecordDetailDrawer } from './RecordDetailDrawer.vue';
+export { default as ReferenceRecordDetailBrowser } from './ReferenceRecordDetailBrowser.vue';
+export { default as ReadonlyReferenceValue } from './ReadonlyReferenceValue.vue';
+export { createReferenceRecordDetailBrowser, provideReferenceRecordDetailBrowser, } from './referenceRecordDetailBrowser';
+export type { ReferenceRecordDetailBrowser as ReferenceRecordDetailBrowserState, ReferenceRecordDetailMutation, } from './referenceRecordDetailBrowser';
 export type { DrawerPromotion } from './drawerPromotion';
 export { default as RecordExternalChangeNotice } from './RecordExternalChangeNotice.vue';
 export { default as RecordDetailFields } from './RecordDetailFields.vue';
@@ -50,6 +56,11 @@ export { default as RecordExplorerPanel } from './RecordExplorerPanel.vue';
 export { default as RecordExplorerCreateButton } from './RecordExplorerCreateButton.vue';
 export type { RecordExplorerItemDescriptor } from './recordExplorerItemModel';
 export { default as RecordFormFields } from './RecordFormFields.vue';
+export { default as DictionaryOptionDialog } from './DictionaryOptionDialog.vue';
+export { default as DictionaryPicker } from './DictionaryPicker.vue';
+export { default as DictionaryRadioGroup } from './DictionaryRadioGroup.vue';
+export type { DictionaryOptionValue, DictionarySelectionMode } from './dictionaryOptionDialogModel';
+export type { DictionaryPickerMode, DictionaryPickerValidity } from './DictionaryPicker.vue';
 export { default as RecordFieldLabel } from './RecordFieldLabel.vue';
 export { default as RecordFormGrid } from './RecordFormGrid.vue';
 export { default as RecordFileReferenceTransfer } from './RecordFileReferenceTransfer.vue';
@@ -58,6 +69,20 @@ export { default as RecordMetaSection } from './RecordMetaSection.vue';
 export { default as RecordModeDrawer } from './RecordModeDrawer.vue';
 export { default as RecordPicker } from './RecordPicker.vue';
 export { default as RecordMultiPicker } from './RecordMultiPicker.vue';
+export { default as ReferencePicker } from './ReferencePicker.vue';
+export { readonlyReferenceDisplay } from './readonlyReferenceDisplay';
+export { createQueryReferencePickerProvider } from './queryReferencePickerProvider';
+export { createSourceReferencePickerProvider, sourceReferencePickerReloadKey, } from './sourceReferencePickerProvider';
+export { createUserReferencePickerProvider, userReferencePickerColumns } from './userReferencePicker';
+export type { UserReferencePickerConfig } from './userReferencePicker';
+export type { ReferencePickerAxisSelection, ReferencePickerBrowseScope, ReferencePickerCandidate, ReferencePickerColumn, ReferencePickerConfig, ReferencePickerId, ReferencePickerNavigationAxis, ReferencePickerNavigationItem, ReferencePickerPage, ReferencePickerPageRequest, ReferencePickerProvider, ReferencePickerSelectionSummary, ReferencePickerSourceIdentity, ReferencePickerTreeNode, ReferencePickerValidity, } from './referencePickerModel';
+export { default as ObjectPickerInput } from './ObjectPickerInput.vue';
+export { default as UserPicker } from './UserPicker.vue';
+export { default as EmployeePicker } from './EmployeePicker.vue';
+export { default as ScopedTreePicker } from './ScopedTreePicker.vue';
+export type { UserAccountId, UserPickerCandidate, UserPickerPage, UserPickerPageRequest, UserPickerPageSearch, UserPickerResolver, UserPickerNavigation, UserPickerNavigationItem, UserPickerNavigationScope, } from './userPickerModel';
+export type { EmployeeId, EmployeePickerCandidate, EmployeePickerConfig, EmployeePickerPage, EmployeePickerPageRequest, EmployeePickerPageSearch, EmployeePickerResolver, } from './employeePickerModel';
+export type { ScopedTreePickerCandidate, ScopedTreePickerChildrenRequest, ScopedTreePickerConfig, ScopedTreePickerPage, ScopedTreePickerProvider, ScopedTreePickerRootRequest, } from './scopedTreePickerModel';
 export { default as RecordQueryListPanel } from './RecordQueryListPanel.vue';
 export { default as RecordQueryListCell } from './RecordQueryListCell.vue';
 export { default as RecycleBinModeButton } from './RecycleBinModeButton.vue';
@@ -104,7 +129,7 @@ export { createPlatformActionResultReactionHandlers, mergePlatformActionResultRe
 export type { PlatformActionResult, PlatformActionResultReaction, PlatformActionResultReactionHandler, PlatformActionResultReactionPayload, PlatformActionResultReactionType, PlatformActionResultStandardReactionHandlers, } from './platformActionResultReactions';
 export type { PlatformActionResultFeedbackContext, PlatformActionResultHandlingContext, } from './platformActionResultFeedback';
 export { executeStaticFormSave, executeStaticRecordAction } from './staticFormActionFlow';
-export { applyRecordExternalChange, createRecordEditorSessionState } from './recordEditorSessionState';
+export { applyRecordExternalChange, createRecordEditorSessionState, recordDraftFingerprint, } from './recordEditorSessionState';
 export { useFlatCrudManagementState } from './staticCrudManagementState';
 export type { PlatformActionErrorHandler, PlatformErrorFeedbackContext } from './platformErrorFeedback';
 export type { StaticFormActionErrorContext, StaticFormActionErrorHandler, StaticFormSaveMode, StaticFormSaveOptions, StaticRecordActionOptions, } from './staticFormActionFlow';
@@ -116,3 +141,5 @@ export type { StaticTreeResourceModuleContextOptions } from './staticTreeResourc
 export { default as RecordRelationTable } from './RecordRelationTable.vue';
 export { default as RecordRelationValue } from './RecordRelationValue.vue';
 export { default as RecordPermissionDialog } from './RecordPermissionDialog.vue';
+export { ReferencePickerReadError } from './referencePickerReadError';
+export type { ReferencePickerReadErrorKind } from './referencePickerReadError';

package/dist/types/platform-components/optionFieldOptionCache.d.ts

@@ -1,3 +1,3 @@
 import type { OptionItemDescriptor } from '../web-contracts/index';
 import type { ModuleContext } from '../web-core/index';
-export declare function loadOptionFieldItems(context: ModuleContext<unknown>, fieldName: string, entityAlias?: string): Promise<OptionItemDescriptor[]>;
+export declare function loadOptionFieldItems(context: ModuleContext<unknown>, fieldName: string, entityAlias?: string, moduleAlias?: string, forceRefresh?: boolean): Promise<OptionItemDescriptor[]>;

package/dist/types/platform-components/queryCriteriaDraft.d.ts

@@ -0,0 +1,24 @@
+import type { QueryOperator } from '../web-contracts/index';
+export interface QueryCriteriaConditionDraft {
+    kind: 'CONDITION';
+    id: number;
+    fieldName?: string;
+    operator?: QueryOperator;
+    values: unknown[];
+}
+export interface QueryCriteriaGroupDraft {
+    kind: 'GROUP';
+    id: number;
+    operator: 'AND' | 'OR';
+    children: QueryCriteriaDraftNode[];
+}
+export type QueryCriteriaDraftNode = QueryCriteriaConditionDraft | QueryCriteriaGroupDraft;
+/**
+ * Mirrors the source-neutral execution limits in QueryCriteria.  The server
+ * remains authoritative; keeping the limits here lets the composer identify
+ * the affected draft row before it sends a request that must be rejected.
+ */
+export declare const QUERY_CRITERIA_MAXIMUM_DEPTH = 4;
+export declare const QUERY_CRITERIA_MAXIMUM_NODES = 50;
+export declare const QUERY_CRITERIA_MAXIMUM_COLLECTION_VALUES = 100;
+export declare function isValueLessQueryOperator(operator: QueryOperator | undefined): operator is "NULL" | "NOT_NULL" | "EMPTY" | "NOT_EMPTY";

package/dist/types/platform-components/queryReferencePickerProvider.d.ts

@@ -0,0 +1,19 @@
+import type { QuerySchemaReference } from '../web-contracts/index';
+import { type HttpClient } from '../web-core/index';
+import type { ReferencePickerProvider } from './referencePickerModel';
+export interface QueryReferencePickerProviderOptions {
+    /**
+     * The HTTP client from the target's REFERENCE module context. The provider constructs its own
+     * navigation-only client instead of accepting an arbitrary context CRUD client.
+     */
+    http: HttpClient;
+    reference: QuerySchemaReference;
+}
+/**
+ * Adapts a query schema's ordinary target reference to the shared picker contract.
+ *
+ * Query schemas deliberately have no source-field resolve contract or dependency semantics. The
+ * only permitted candidate transport here is the target module's REFERENCE navigator endpoint;
+ * this is intentionally different from both ordinary target CRUD and source-field resolution.
+ */
+export declare function createQueryReferencePickerProvider({ http, reference, }: QueryReferencePickerProviderOptions): ReferencePickerProvider;

package/dist/types/platform-components/readonlyReferenceDisplay.d.ts

@@ -0,0 +1,19 @@
+import type { ResolvedReferenceFieldDescriptor } from '../web-contracts/index';
+export interface ReadonlyReferenceDisplayItem {
+    id: string;
+    label: string;
+    /** Only a delivered, usable projection may enter the target-detail browser. */
+    browseable: boolean;
+}
+/**
+ * Formats only record-projected reference facts. It never resolves candidates: an absent title
+ * remains the persisted ID, which distinguishes an unavailable projection from a deleted or
+ * unauthorized target.
+ */
+export declare function readonlyReferenceDisplay(reference: Pick<ResolvedReferenceFieldDescriptor, 'cardinality'>, value: unknown, summary: unknown): string | undefined;
+/**
+ * Keeps the persisted reference order while retaining enough projection identity for the shared
+ * read-only browser. A raw ID intentionally remains non-interactive: it may be absent, deleted,
+ * or hidden by a target data scope.
+ */
+export declare function readonlyReferenceDisplayItems(reference: Pick<ResolvedReferenceFieldDescriptor, 'cardinality'>, value: unknown, summary: unknown): ReadonlyReferenceDisplayItem[];