@astryx-vue/core 0.2.0 → 0.2.2

package/dist/index-Cs5pcwY3.d.ts

@@ -0,0 +1,416 @@
+import { a as SearchableItem, i as SearchSource } from "./useAsyncSource-xpQovjV_.js";
+import { t as PowerSearchMessages } from "./power-search-DrDfcoL1.js";
+import { Component, VNodeChild } from "vue";
+//#region src/PowerSearch/types.d.ts
+interface EmptyOperatorValue {
+  readonly type: 'empty';
+}
+interface StringOperatorValue {
+  readonly type: 'string';
+  readonly searchSource?: SearchSource;
+  readonly isArbitraryStringAllowed?: boolean;
+}
+interface OperatorTokenizationConfig {
+  readonly regex?: string;
+  readonly sort?: boolean;
+}
+interface StringListOperatorValue {
+  readonly type: 'string_list';
+  readonly searchSource?: SearchSource;
+  readonly isArbitraryStringAllowed?: boolean;
+  readonly tokenization?: OperatorTokenizationConfig;
+}
+interface IntegerOperatorValue {
+  readonly type: 'integer';
+  readonly minValue?: number;
+  readonly maxValue?: number;
+  readonly units?: string;
+}
+interface FloatOperatorValue {
+  readonly type: 'float';
+  readonly minValue?: number;
+  readonly maxValue?: number;
+  readonly units?: string;
+}
+interface TimeOperatorValue {
+  readonly type: 'time';
+  readonly minValue?: string;
+  readonly maxValue?: string;
+}
+interface DateAbsoluteOperatorValue {
+  readonly type: 'date_absolute';
+  readonly isDateOnly?: boolean;
+}
+interface DateRelativeOperatorValue {
+  readonly type: 'date_relative';
+  readonly isPastAllowed?: boolean;
+  readonly isFutureAllowed?: boolean;
+}
+type DateTimeRangePart = {
+  readonly type: 'NOW';
+} | {
+  readonly type: 'ABSOLUTE';
+  readonly unixSeconds: number;
+} | {
+  readonly type: 'RELATIVE';
+  readonly backValue: number;
+  readonly unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+  readonly anchorKey?: string;
+};
+interface DateTimeRange {
+  readonly start: DateTimeRangePart;
+  readonly end: DateTimeRangePart;
+}
+interface DateRangeFilterPreset {
+  readonly label: string;
+  readonly value: DateTimeRange;
+}
+interface RelativeDateFilterPreset {
+  readonly label: string;
+  readonly value: string;
+}
+interface DateRangeOperatorValue {
+  readonly type: 'date_range';
+  readonly intervalDatePresets?: readonly DateRangeFilterPreset[];
+  readonly relativeDatePresets?: readonly RelativeDateFilterPreset[];
+}
+interface EnumItem {
+  readonly value: string;
+  readonly label: string;
+  /** 内置图形名，或 `collection:icon`。 */
+  readonly icon?: string;
+}
+interface EnumOperatorValue {
+  readonly type: 'enum';
+  readonly values: readonly EnumItem[];
+}
+interface EnumListOperatorValue {
+  readonly type: 'enum_list';
+  readonly values: readonly EnumItem[];
+}
+interface EntityListOperatorValue {
+  readonly type: 'entity_list';
+  readonly searchSource?: SearchSource;
+  readonly isArbitraryStringAllowed?: boolean;
+  readonly tokenization?: OperatorTokenizationConfig;
+}
+interface CustomOperatorValue {
+  readonly type: 'custom';
+  readonly Editor: Component;
+  readonly getString: (value: string) => string;
+}
+interface NestedOperatorValue {
+  readonly type: 'nested';
+}
+type OperatorValue = EmptyOperatorValue | StringOperatorValue | StringListOperatorValue | IntegerOperatorValue | FloatOperatorValue | TimeOperatorValue | DateAbsoluteOperatorValue | DateRelativeOperatorValue | DateRangeOperatorValue | EnumOperatorValue | EnumListOperatorValue | EntityListOperatorValue | CustomOperatorValue | NestedOperatorValue;
+interface FilterValueEmpty {
+  readonly type: 'empty';
+}
+interface FilterValueString {
+  readonly type: 'string';
+  readonly value: string;
+}
+interface FilterValueStringList {
+  readonly type: 'string_list';
+  readonly value: readonly string[];
+}
+interface FilterValueInteger {
+  readonly type: 'integer';
+  readonly value: number;
+}
+interface FilterValueFloat {
+  readonly type: 'float';
+  readonly value: number;
+}
+interface FilterValueTime {
+  readonly type: 'time';
+  readonly value: string;
+}
+interface FilterValueDateAbsolute {
+  readonly type: 'date_absolute';
+  readonly unixSeconds: number;
+}
+interface FilterValueDateRelative {
+  readonly type: 'date_relative';
+  readonly value: string;
+}
+interface FilterValueDateRange {
+  readonly type: 'date_range';
+  readonly value: DateTimeRange;
+}
+interface FilterValueEnum {
+  readonly type: 'enum';
+  readonly value: string;
+}
+interface FilterValueEnumList {
+  readonly type: 'enum_list';
+  readonly value: readonly string[];
+}
+interface PowerSearchEntity {
+  readonly id: string;
+  readonly label: string;
+  readonly photo?: string;
+}
+interface FilterValueEntityList {
+  readonly type: 'entity_list';
+  readonly value: readonly PowerSearchEntity[];
+}
+interface FilterValueCustom {
+  readonly type: 'custom';
+  readonly value: string;
+}
+interface FilterValueNested {
+  readonly type: 'nested';
+  readonly value: readonly PowerSearchFilter[];
+}
+type FilterValue = FilterValueEmpty | FilterValueString | FilterValueStringList | FilterValueInteger | FilterValueFloat | FilterValueTime | FilterValueDateAbsolute | FilterValueDateRelative | FilterValueDateRange | FilterValueEnum | FilterValueEnumList | FilterValueEntityList | FilterValueCustom | FilterValueNested;
+interface PowerSearchOperatorBase {
+  readonly key: string;
+  readonly value: OperatorValue;
+}
+interface PowerSearchOperatorWithLabel extends PowerSearchOperatorBase {
+  readonly label: string;
+  readonly i18nKey?: never;
+}
+interface PowerSearchOperatorWithI18nKey extends PowerSearchOperatorBase {
+  readonly i18nKey: string;
+  readonly label?: never;
+}
+type PowerSearchOperator = PowerSearchOperatorWithLabel | PowerSearchOperatorWithI18nKey;
+interface PowerSearchField {
+  readonly key: string;
+  readonly label: string;
+  readonly operators: readonly PowerSearchOperator[];
+  readonly icon?: string;
+  readonly defaultOperator?: string;
+  readonly group?: string;
+  readonly description?: string;
+  readonly typeaheadAliases?: readonly string[];
+  readonly typeaheadMinQueryLength?: number;
+  readonly isValueMatchAllowed?: boolean;
+}
+interface PowerSearchConfig {
+  readonly name: string;
+  readonly fields: readonly PowerSearchField[];
+  readonly contentSearchFieldKey?: string;
+}
+interface PowerSearchFilter {
+  readonly field: string;
+  readonly operator: string;
+  readonly value: FilterValue;
+  readonly isReadOnly?: boolean;
+}
+interface PartialFilter {
+  readonly field: string;
+  readonly operator?: string;
+  readonly value?: FilterValue;
+  readonly isReadOnly?: boolean;
+}
+type PowerSearchChangeType = 'add' | 'edit' | 'remove';
+interface PowerSearchHandle {
+  focusTypeahead: () => void;
+  blurTypeahead: () => void;
+}
+interface PowerSearchAuxData {
+  readonly fieldKey: string;
+  readonly operatorKey?: string;
+  readonly filterValue?: FilterValue;
+  readonly filterIndex?: number;
+  readonly group?: string;
+}
+type PowerSearchItem = SearchableItem<PowerSearchAuxData>;
+type PowerSearchSize = 'sm' | 'md' | 'lg';
+type PowerSearchStatus = 'default' | 'success' | 'warning' | 'error';
+type PowerSearchStatusVariant = 'attached' | 'detached';
+type PowerSearchOverflow = 'none' | 'unfocused-inline' | 'unfocused-layer';
+interface PowerSearchTokenProps {
+  config: PowerSearchConfig;
+  filter: PowerSearchFilter;
+  field: PowerSearchField;
+  operator: PowerSearchOperator;
+  maxLength: number;
+  disabled?: boolean;
+  onClick?: () => void;
+  onRemove?: () => void;
+}
+interface PowerSearchEditorProps {
+  config: PowerSearchConfig;
+  filter: PartialFilter;
+  mode: 'create' | 'edit';
+  saveLabel?: string;
+  readOnly?: boolean;
+  timeZone?: string;
+  maxMenuItems?: number;
+  onSave: (filter: PowerSearchFilter | null) => void;
+  onCancel: () => void;
+}
+interface PowerSearchComponentOverride {
+  token?: Component;
+  editor?: Component;
+}
+type PowerSearchComponents = Partial<Record<OperatorValue['type'], PowerSearchComponentOverride>>;
+interface PowerSearchProps {
+  config: PowerSearchConfig;
+  filters?: readonly PowerSearchFilter[];
+  label?: string;
+  labelHidden?: boolean;
+  placeholder?: string;
+  autofocus?: boolean;
+  clearable?: boolean;
+  readOnly?: boolean;
+  disabled?: boolean;
+  disabledReason?: string;
+  status?: PowerSearchStatus;
+  statusMessage?: string;
+  statusVariant?: PowerSearchStatusVariant;
+  maxTokenLength?: number;
+  maxOperatorMenuItems?: number;
+  maxSearchResults?: number;
+  menuWidth?: number;
+  saveLabel?: string;
+  timeZone?: string;
+  overflow?: PowerSearchOverflow;
+  resultCount?: number | string;
+  size?: PowerSearchSize;
+  components?: PowerSearchComponents;
+}
+interface PowerSearchEmits {
+  'update:filters': [filters: PowerSearchFilter[]];
+  'change': [filters: PowerSearchFilter[], changeType: PowerSearchChangeType, index: number];
+  'focus': [event: FocusEvent];
+  'blur': [event: FocusEvent];
+}
+interface PowerSearchSlots {
+  icon?: () => VNodeChild;
+  end?: () => VNodeChild;
+  token?: (props: PowerSearchTokenProps) => VNodeChild;
+  editor?: (props: PowerSearchEditorProps) => VNodeChild;
+}
+type PowerSearchFieldType = 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'enum_list' | 'string_list';
+interface PowerSearchFieldDefinition<K extends string = string, T extends PowerSearchFieldType = PowerSearchFieldType> {
+  readonly key: K;
+  readonly type: T;
+  readonly label?: string;
+  readonly enumValues?: readonly EnumItem[];
+}
+//#endregion
+//#region src/PowerSearch/config.d.ts
+interface PowerSearchLookup {
+  readonly config: PowerSearchConfig;
+  getField: (key: string) => PowerSearchField | undefined;
+  getOperator: (fieldKey: string, operatorKey: string) => PowerSearchOperator | undefined;
+  getDefaultOperator: (fieldKey: string) => PowerSearchOperator | undefined;
+  getVisibleFields: () => readonly PowerSearchField[];
+  getVisibleOperators: (fieldKey: string) => readonly PowerSearchOperator[];
+}
+declare function createPowerSearchLookup(config: PowerSearchConfig): PowerSearchLookup;
+//#endregion
+//#region src/PowerSearch/complete.d.ts
+/** 编辑器里的半成品条件。嵌套子条件放在 children，填完才写进 value。 */
+interface EditableFilter {
+  readonly field: string;
+  readonly operator?: string;
+  readonly value?: FilterValue;
+  readonly children?: readonly EditableFilter[];
+  readonly isReadOnly?: boolean;
+}
+/** 条件齐全才返回可保存的筛选。嵌套里有没填完的子条件时返回空。 */
+declare function completePowerSearchFilter(partial: EditableFilter | PartialFilter, lookup: PowerSearchLookup): PowerSearchFilter | null;
+//#endregion
+//#region src/PowerSearch/format.d.ts
+declare function formatDateAbsolute(unixSeconds: number, locale: string, timeZone?: string): string;
+declare function formatDateAbsoluteCompact(unixSeconds: number, locale: string, timeZone?: string): string;
+declare function formatFilterValue(operatorValue: OperatorValue, filterValue: FilterValue, maxLength: number, messages: PowerSearchMessages, locale: string, timeZone?: string): string;
+//#endregion
+//#region src/PowerSearch/operators.d.ts
+declare function resolveOperatorLabel(operator: PowerSearchOperator, messages: PowerSearchMessages): string;
+//#endregion
+//#region src/PowerSearch/placement.d.ts
+interface EditorBox {
+  left: number;
+  right: number;
+  width: number;
+}
+interface EditorPlacementInput {
+  outer: EditorBox;
+  control: EditorBox;
+  viewportWidth: number;
+  direction: 'ltr' | 'rtl';
+  /** 视口左右各留出的安全距离。 */
+  viewportInset?: number;
+}
+interface EditorPlacement {
+  width: number;
+  /** 编辑器比外层窄，需要对齐到打开它的控件靠近的那一侧。 */
+  capped: boolean;
+  edge: 'left' | 'right';
+  top: number;
+  left: number;
+}
+/**
+ * 编辑器宽度取外层宽度，再夹在 400 到 720 之间。
+ * 视口放不下 400 时，下限让给视口。只有被 720 压窄时，才改贴打开控件更近的外缘。
+ */
+declare function resolveEditorPlacement(input: EditorPlacementInput & {
+  anchorTop: number;
+  anchorBottom: number;
+  viewportHeight: number;
+}): EditorPlacement;
+//#endregion
+//#region src/PowerSearch/PowerSearch.vue.d.ts
+type __VLS_Slots = PowerSearchSlots;
+declare const __VLS_base: import("vue").DefineComponent<PowerSearchProps, {
+  focusTypeahead: () => void | undefined;
+  blurTypeahead: () => void | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  blur: (event: FocusEvent) => any;
+  focus: (event: FocusEvent) => any;
+  change: (filters: PowerSearchFilter[], changeType: PowerSearchChangeType, index: number) => any;
+  "update:filters": (filters: PowerSearchFilter[]) => any;
+}, string, import("vue").PublicProps, Readonly<PowerSearchProps> & Readonly<{
+  onBlur?: ((event: FocusEvent) => any) | undefined;
+  onFocus?: ((event: FocusEvent) => any) | undefined;
+  onChange?: ((filters: PowerSearchFilter[], changeType: PowerSearchChangeType, index: number) => any) | undefined;
+  "onUpdate:filters"?: ((filters: PowerSearchFilter[]) => any) | undefined;
+}>, {
+  size: PowerSearchSize;
+  status: PowerSearchStatus;
+  statusVariant: PowerSearchStatusVariant;
+  disabled: boolean;
+  labelHidden: boolean;
+  clearable: boolean;
+  overflow: PowerSearchOverflow;
+  readOnly: boolean;
+  maxTokenLength: number;
+  maxSearchResults: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/PowerSearch/query.d.ts
+interface FieldTypeToValue {
+  string: string;
+  number: number;
+  boolean: boolean;
+  date: Date | number;
+  enum: string;
+  enum_list: readonly string[];
+  string_list: readonly string[];
+}
+type InferPowerSearchData<D extends readonly PowerSearchFieldDefinition[]> = { [F in D[number] as F['key']]: FieldTypeToValue[F['type']]; };
+declare function applyPowerSearchFilters<T extends Record<string, unknown>>(filters: readonly PowerSearchFilter[], data: readonly T[]): T[];
+declare function createPowerSearchConfig<const D extends readonly PowerSearchFieldDefinition[]>(definitions: D, configName?: string): {
+  config: PowerSearchConfig;
+  applyFilters: <T extends InferPowerSearchData<D>>(filters: readonly PowerSearchFilter[], data: readonly T[]) => T[];
+};
+declare function usePowerSearchConfig<const D extends readonly PowerSearchFieldDefinition[]>(definitions: D, configName?: string): ReturnType<typeof createPowerSearchConfig<D>>;
+//#endregion
+//#region src/PowerSearch/source.d.ts
+declare function searchPowerSearchFields(lookup: PowerSearchLookup, query: string, messages: PowerSearchMessages, maxTypedResults: number): PowerSearchItem[];
+//#endregion
+export { PowerSearchItem as A, PowerSearchEmits as C, PowerSearchFieldType as D, PowerSearchFieldDefinition as E, PowerSearchSlots as F, PowerSearchStatus as I, PowerSearchOverflow as M, PowerSearchProps as N, PowerSearchFilter as O, PowerSearchSize as P, PowerSearchConfig as S, PowerSearchField as T, FilterValue as _, usePowerSearchConfig as a, PowerSearchChangeType as b, resolveOperatorLabel as c, formatFilterValue as d, completePowerSearchFilter as f, DateTimeRangePart as g, DateTimeRange as h, createPowerSearchConfig as i, PowerSearchOperator as j, PowerSearchHandle as k, formatDateAbsolute as l, createPowerSearchLookup as m, InferPowerSearchData as n, _default as o, PowerSearchLookup as p, applyPowerSearchFilters as r, resolveEditorPlacement as s, searchPowerSearchFields as t, formatDateAbsoluteCompact as u, OperatorValue as v, PowerSearchEntity as w, PowerSearchComponents as x, PartialFilter as y };

package/dist/{index-NzLDrOkk.d.ts → index-D4I_obqR.d.ts}

@@ -1,4 +1,7 @@
+import { c as FieldStatusType, o as FieldStatusInput } from "./types-3eXh_5os.js";
 //#region src/NumberInput/types.d.ts
+/** 带说明的校验状态。仍接受单独的状态字符串。 */
+type NumberInputStatus = FieldStatusInput | 'default' | FieldStatusType;
 interface NumberInputProps {
   /** 当前值 */
   modelValue?: number | null;
@@ -18,6 +21,16 @@ interface NumberInputProps {
   size?: 'sm' | 'md' | 'lg';
   /** 标签 */
   label?: string;
+  /** 标签下方的说明 */
+  description?: string;
+  /** 只把标签留给读屏 */
+  isLabelHidden?: boolean;
+  /** 单位，显示在步进按钮前面，例如 % */
+  units?: string;
+  /** 有值时显示清除按钮 */
+  clearable?: boolean;
+  /** 校验状态。对象形式会在字段下方显示说明。 */
+  status?: NumberInputStatus;
   /** 名称（用于表单提交） */
   name?: string;
 }
@@ -42,4 +55,4 @@ declare const __VLS_export: import("vue").DefineComponent<NumberInputProps, {},
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
-export { NumberInputEmits as n, NumberInputProps as r, _default as t };
+export { NumberInputStatus as i, NumberInputEmits as n, NumberInputProps as r, _default as t };

package/dist/{index-BtPZKO20.d.ts → index-DGXviOlp.d.ts}

@@ -1,29 +1,61 @@
+import { o as FieldStatusInput } from "./types-3eXh_5os.js";
 //#region src/Selector/types.d.ts
 interface SelectorOption {
   value: string | number;
   label: string;
   disabled?: boolean;
   description?: string;
+  /** CSS icon class or a component, drawn before the label. */
+  icon?: string;
 }
+/** 字符串会当成 value 和 label 相同的选项，演练场模板一直这样传。 */
+type SelectorOptionInput = SelectorOption | string;
+/** A titled group of options. */
+interface SelectorSection {
+  type: 'section';
+  title?: string;
+  options: readonly SelectorOption[];
+}
+type SelectorEntry = SelectorOptionInput | SelectorSection;
 type SelectorSize = 'sm' | 'md' | 'lg';
 type SelectorStatus = 'default' | 'success' | 'warning' | 'error';
+/** 字符串状态，或演练场里那种 `{ type, message }`。 */
+type SelectorStatusInput = SelectorStatus | FieldStatusInput;
+type SelectorPresentation = 'popover' | 'bottom-sheet';
+type SelectorVariant = 'default' | 'ghost';
+type SelectorStatusVariant = 'attached' | 'detached' | 'tooltip';
 interface SelectorProps {
   /** 选中的值 */
   modelValue?: string | number | null;
-  /** 选项列表 */
-  options: readonly SelectorOption[];
+  /** 选项列表，可以按 section 分组 */
+  options: readonly SelectorEntry[];
   /** 占位文本 */
   placeholder?: string;
   /** 是否禁用 */
   disabled?: boolean;
   /** 禁用原因（鼠标悬停时显示） */
   disabledReason?: string;
-  /** 状态 */
-  status?: SelectorStatus;
+  /** 状态。可以是 `'error'`，也可以是 `{ type, message }`。 */
+  status?: SelectorStatusInput;
   /** 状态消息 */
   statusMessage?: string;
+  /**
+   * 状态文案的呈现。tooltip 只留给读屏，不在控件下再画一行。
+   * @default 'attached'
+   */
+  statusVariant?: SelectorStatusVariant;
   /** 尺寸 */
   size?: SelectorSize;
+  /**
+   * default 是带边框的输入框，ghost 去掉边框，适合放进工具栏。
+   * @default 'default'
+   */
+  variant?: SelectorVariant;
+  /**
+   * popover 锚在触发器下，bottom-sheet 在底部弹层里展开。
+   * @default 'popover'
+   */
+  presentation?: SelectorPresentation;
   /** 是否可搜索 */
   searchable?: boolean;
   /** 搜索占位文本 */
@@ -34,8 +66,14 @@ interface SelectorProps {
   clearLabel?: string;
   /** 空状态文本 */
   emptyText?: string;
-  /** 标签（用于无障碍） */
+  /** 可见标签。不传时用占位文本作为隐藏的无障碍名称。 */
   label?: string;
+  /** 隐藏可见标签，仍保留给读屏。 */
+  isLabelHidden?: boolean;
+  /** 标签下方的说明 */
+  description?: string;
+  /** 控件宽度。数字按像素，字符串原样使用。 */
+  width?: number | string;
   /** 名称（用于表单提交） */
   name?: string;
 }
@@ -71,10 +109,14 @@ declare const __VLS_base: import("vue").DefineComponent<SelectorProps, {}, {}, {
   "onUpdate:modelValue"?: ((value: string | number | null) => any) | undefined;
 }>, {
   size: SelectorSize;
-  status: SelectorStatus;
+  variant: SelectorVariant;
+  status: SelectorStatusInput;
   modelValue: string | number | null;
+  isLabelHidden: boolean;
+  statusVariant: SelectorStatusVariant;
   disabled: boolean;
   clearable: boolean;
+  presentation: SelectorPresentation;
   searchable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
@@ -85,4 +127,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { SelectorSize as a, SelectorProps as i, SelectorEmits as n, SelectorSlots as o, SelectorOption as r, SelectorStatus as s, _default as t };
+export { SelectorOptionInput as a, SelectorSection as c, SelectorStatus as d, SelectorStatusInput as f, SelectorOption as i, SelectorSize as l, SelectorVariant as m, SelectorEmits as n, SelectorPresentation as o, SelectorStatusVariant as p, SelectorEntry as r, SelectorProps as s, _default as t, SelectorSlots as u };

package/dist/{index-CTolyeii.d.ts → index-DN7MXPHM.d.ts}

@@ -15,6 +15,14 @@ type ContextMenuSize = 'sm' | 'md' | 'lg';
  * text flow.
  */
 type ContextMenuTriggerElement = 'div' | 'span';
+/**
+ * How the actions are presented.
+ *
+ * `popover` anchors a menu to the pointer, `bottom-sheet` presents a
+ * thumb-reachable sheet, and `adaptive` uses the sheet at 768px and below
+ * when the primary pointer is coarse.
+ */
+type ContextMenuPresentation = 'popover' | 'bottom-sheet' | 'adaptive';
 /** A menu width as a number of pixels or any CSS length. */
 type ContextMenuWidth = number | string;
 /**
@@ -134,6 +142,11 @@ interface ContextMenuProps {
    * @default 'div'
    */
   triggerAs?: ContextMenuTriggerElement;
+  /**
+   * How the menu is presented.
+   * @default 'popover'
+   */
+  presentation?: ContextMenuPresentation;
   /**
    * Open state of the menu. Bind it with `v-model:is-open` to control the
    * menu from the outside; leave it unbound and the menu manages its own
@@ -316,6 +329,7 @@ declare const __VLS_base$3: import("vue").DefineComponent<__VLS_PublicProps, {
   label: string;
   size: ContextMenuSize;
   isDisabled: boolean;
+  presentation: ContextMenuPresentation;
   triggerAs: ContextMenuTriggerElement;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$4: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
@@ -381,4 +395,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { ContextMenuSlots as C, ContextMenuTriggerElement as D, ContextMenuSubMenuSlots as E, ContextMenuVariant as O, ContextMenuSize as S, ContextMenuSubMenuProps as T, ContextMenuItemSlots as _, _default$4 as a, ContextMenuProps as b, ContextMenuDividerData as c, ContextMenuGroupProps as d, ContextMenuGroupSlots as f, ContextMenuItemProps as g, ContextMenuItemIcon as h, _default$3 as i, ContextMenuWidth as k, ContextMenuDividerProps as l, ContextMenuItemEmits as m, _default$1 as n, useContextMenu as o, ContextMenuItemData as p, _default$2 as r, useContextMenuSize as s, _default as t, ContextMenuEmits as u, ContextMenuItemTarget as v, ContextMenuSubMenuEmits as w, ContextMenuSection as x, ContextMenuOption as y };
+export { ContextMenuWidth as A, ContextMenuSize as C, ContextMenuSubMenuSlots as D, ContextMenuSubMenuProps as E, ContextMenuTriggerElement as O, ContextMenuSection as S, ContextMenuSubMenuEmits as T, ContextMenuItemSlots as _, _default$4 as a, ContextMenuPresentation as b, ContextMenuDividerData as c, ContextMenuGroupProps as d, ContextMenuGroupSlots as f, ContextMenuItemProps as g, ContextMenuItemIcon as h, _default$3 as i, ContextMenuVariant as k, ContextMenuDividerProps as l, ContextMenuItemEmits as m, _default$1 as n, useContextMenu as o, ContextMenuItemData as p, _default$2 as r, useContextMenuSize as s, _default as t, ContextMenuEmits as u, ContextMenuItemTarget as v, ContextMenuSlots as w, ContextMenuProps as x, ContextMenuOption as y };