@ximatai/muyun-web-app 0.26.12 → 0.26.14

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

@@ -36,7 +36,7 @@ declare var __VLS_1: {
     group: import("../web-contracts/index").FormGroupDescriptor | undefined;
 }, __VLS_12: {
     field: RecordFormFieldState;
-}, __VLS_146: {
+}, __VLS_196: {
     field: RecordFormFieldState;
 };
 type __VLS_Slots = {} & {
@@ -46,29 +46,29 @@ type __VLS_Slots = {} & {
 } & {
     'field-actions'?: (props: typeof __VLS_12) => any;
 } & {
-    'after-field'?: (props: typeof __VLS_146) => any;
+    'after-field'?: (props: typeof __VLS_196) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:field": (fieldName: string, value: RecordFormFieldValue) => any;
     "validity-change": (validity: RecordFormValidity) => any;
+    "update:field": (fieldName: string, value: RecordFormFieldValue) => any;
     "reference-projections-change": (fieldName: string, projections: Record<string, unknown>) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:field"?: ((fieldName: string, value: RecordFormFieldValue) => any) | undefined;
     "onValidity-change"?: ((validity: RecordFormValidity) => any) | undefined;
+    "onUpdate:field"?: ((fieldName: string, value: RecordFormFieldValue) => any) | undefined;
     "onReference-projections-change"?: ((fieldName: string, projections: Record<string, unknown>) => any) | undefined;
 }>, {
     disabled: boolean;
     compact: boolean;
     fieldNames: string[];
     fields: Map<string, RecordFormFieldDescriptor>;
+    fallback: Record<string, RecordFormFieldFallback>;
     formSessionKey: string | number;
     excludeFieldNames: string[];
-    fallback: Record<string, RecordFormFieldFallback>;
-    pickerConfigs: Record<string, RecordFormFieldPickerConfig>;
     optionContext: ModuleContext<unknown>;
     fileTransferContext: ModuleContext<unknown>;
     layoutTransitionPrefix: string;
     optionEntityAlias: string;
+    pickerConfigs: Record<string, RecordFormFieldPickerConfig>;
     validationRequestKey: number;
     showLabels: boolean;
     disabledOf: (fieldName: string, field: RecordFormFieldState) => boolean;

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/RecordQueryListCell.vue.d.ts

@@ -1,4 +1,4 @@
-import type { QueryListRecord, RecordQueryListColumn } from './recordQueryListColumnModel';
+import { type QueryListRecord, type RecordQueryListColumn } from './recordQueryListColumnModel';
 type __VLS_Props = {
     record: QueryListRecord;
     column: RecordQueryListColumn;

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

@@ -1,7 +1,9 @@
-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';
+import type { RecordQueryListQueryController } from './recordQueryListQueryController';
 export type { QueryListRecord, RecordQueryListCellComponent, RecordQueryListColumn, RecordQueryListMode, StandardCrudRowActionKey, } from './recordQueryListColumnModel';
 declare const _default: typeof __VLS_export;
 export default _default;
@@ -56,10 +58,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. */
@@ -82,10 +88,13 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     rowDblclick: (record: QueryListRecord, event: MouseEvent) => any;
     rowExpand: (record: QueryListRecord, expanded: boolean) => any;
     restored: () => any;
+    queryControllerChange: (controller: RecordQueryListQueryController | undefined) => 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 +146,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. */
@@ -160,10 +173,13 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     onRowDblclick?: ((record: QueryListRecord, event: MouseEvent) => any) | undefined;
     onRowExpand?: ((record: QueryListRecord, expanded: boolean) => any) | undefined;
     onRestored?: (() => any) | undefined;
+    onQueryControllerChange?: ((controller: RecordQueryListQueryController | undefined) => 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 +203,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,16 +222,19 @@ 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;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    /** Page/list operations rendered left of query controls. */
+    operations?: (props: {
+        refresh: () => void;
+    }) => unknown;
+    /** @deprecated Use operations so the slot names the semantic region instead of its visual container. */
     toolbarActions?: (props: {
         refresh: () => void;
     }) => unknown;

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/TreeRecordExplorer.vue.d.ts

@@ -2,6 +2,7 @@ import { type UiRecordInlineAction } from '../vue-ui-antdv/index';
 import type { ModuleContext } from '../web-core/index';
 import type { RecordExplorerItemDescriptor } from './recordExplorerItemModel';
 import { type TreeRecordBase } from './treeRecordModel';
+import type { RecordTreeQueryController } from './recordTreeQueryController';
 type TreeRecordSearchMode = 'always' | 'collapsible' | 'none';
 type __VLS_Props = {
     context: ModuleContext<TreeRecordBase>;
@@ -39,16 +40,18 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
     toggleSearch: typeof toggleSearch;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     action: (action: import("../web-contracts/index").RecordInlineAction, record: TreeRecordBase) => any;
-    select: (record: TreeRecordBase) => any;
+    select: (record: TreeRecordBase, source?: "assistant" | undefined) => any;
     loaded: (records: TreeRecordBase[]) => any;
     deselect: () => any;
     sorted: () => any;
+    queryControllerChange: (controller: RecordTreeQueryController | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onAction?: ((action: import("../web-contracts/index").RecordInlineAction, record: TreeRecordBase) => any) | undefined;
-    onSelect?: ((record: TreeRecordBase) => any) | undefined;
+    onSelect?: ((record: TreeRecordBase, source?: "assistant" | undefined) => any) | undefined;
     onLoaded?: ((records: TreeRecordBase[]) => any) | undefined;
     onDeselect?: (() => any) | undefined;
     onSorted?: (() => any) | undefined;
+    onQueryControllerChange?: ((controller: RecordTreeQueryController | undefined) => any) | undefined;
 }>, {
     sortPartitionFields: string[];
     filterOption: (record: TreeRecordBase, normalizedKeyword: string) => boolean;

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>[]>;