@dskripchenko/ui 1.6.2 → 1.8.0

package/dist/components/Cascader/UidCascader.vue.d.ts

@@ -1,3 +1,4 @@
+import { Size } from '../../types/index.js';
 export type CascaderValue = string | number;
 export interface CascaderOption {
     value: CascaderValue;
@@ -6,6 +7,8 @@ export interface CascaderOption {
     disabled?: boolean;
 }
 export interface UidCascaderProps {
+    /** Control height of the shared size scale (`--uid-size-sm|md|lg`). */
+    size?: Size;
     options: CascaderOption[];
     placeholder?: string;
     separator?: string;
@@ -29,6 +32,7 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     "onUpdate:modelValue"?: ((value: CascaderValue[]) => any) | undefined;
     onChange?: ((value: CascaderValue[], path: CascaderOption[]) => any) | undefined;
 }>, {
+    size: Size;
     disabled: boolean;
     separator: string;
     searchable: boolean;
@@ -39,6 +43,7 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     containerRef: HTMLDivElement;
     triggerRef: HTMLDivElement;
+    panelRef: HTMLDivElement;
     searchRef: HTMLInputElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/components/Checkbox/UidCheckbox.vue.d.ts

@@ -22,8 +22,8 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     label: string;
     required: boolean;
     disabled: boolean;
-    hint: string;
     error: string;
+    hint: string;
     name: string;
     id: string;
     indeterminate: boolean;

package/dist/components/Checkbox/UidCheckboxGroup.vue.d.ts

@@ -28,8 +28,8 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     label: string;
     required: boolean;
     disabled: boolean;
-    hint: string;
     error: string;
+    hint: string;
     name: string;
     direction: "horizontal" | "vertical";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;

package/dist/components/Code/UidCode.vue.d.ts

@@ -21,12 +21,12 @@ declare function __VLS_template(): {
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<UidCodeProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<UidCodeProps> & Readonly<{}>, {
     code: string;
-    inline: boolean;
     copy: boolean;
+    inline: boolean;
     wrap: boolean;
+    maxHeight: string;
     language: string;
     lineNumbers: boolean;
-    maxHeight: string;
     highlight: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

package/dist/components/ColorPicker/UidColorPicker.vue.d.ts

@@ -1,7 +1,11 @@
+import { Size } from '../../types/index.js';
 export interface UidColorPickerProps {
+    /** Control height of the shared size scale (`--uid-size-sm|md|lg`). */
+    size?: Size;
     disabled?: boolean;
     presets?: string[];
     alpha?: boolean;
+    placeholder?: string;
 }
 type __VLS_Props = UidColorPickerProps;
 type __VLS_PublicProps = {
@@ -14,11 +18,15 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     "onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
     onChange?: ((value: string | null) => any) | undefined;
 }>, {
+    size: Size;
     disabled: boolean;
+    placeholder: string;
     alpha: boolean;
     presets: string[];
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     containerRef: HTMLDivElement;
+    triggerRef: HTMLButtonElement;
+    panelRef: HTMLDivElement;
     gradientRef: HTMLDivElement;
     hueSliderRef: HTMLDivElement;
     alphaSliderRef: HTMLDivElement;

package/dist/components/Combobox/UidCombobox.vue.d.ts

@@ -41,6 +41,7 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     allowCreate: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     containerRef: HTMLDivElement;
+    controlRef: HTMLDivElement;
     inputRef: HTMLInputElement;
     listRef: HTMLDivElement;
 }, HTMLDivElement>;

package/dist/components/DatePicker/UidDatePicker.vue.d.ts

@@ -1,4 +1,7 @@
+import { Size } from '../../types/index.js';
 export interface UidDatePickerProps {
+    /** Control height of the shared size scale (`--uid-size-sm|md|lg`). */
+    size?: Size;
     min?: string;
     max?: string;
     disabled?: boolean;
@@ -14,6 +17,7 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
 }>, {
+    size: Size;
     disabled: boolean;
     min: string;
     max: string;
@@ -21,6 +25,7 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     containerRef: HTMLDivElement;
     triggerRef: HTMLDivElement;
+    panelRef: HTMLDivElement;
     gridRef: HTMLDivElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/components/DateRangePicker/UidDateRangePicker.vue.d.ts

@@ -1,3 +1,4 @@
+import { Size } from '../../types/index.js';
 export interface DateRange {
     start: string | null;
     end: string | null;
@@ -7,6 +8,8 @@ export interface DateRangePreset {
     range: () => DateRange;
 }
 export interface UidDateRangePickerProps {
+    /** Control height of the shared size scale (`--uid-size-sm|md|lg`). */
+    size?: Size;
     min?: string;
     max?: string;
     disabled?: boolean;
@@ -18,15 +21,16 @@ export interface UidDateRangePickerProps {
 }
 type __VLS_Props = UidDateRangePickerProps;
 type __VLS_PublicProps = {
-    modelValue?: DateRange;
+    modelValue?: DateRange | null;
 } & __VLS_Props;
 declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (value: DateRange) => any;
+    "update:modelValue": (value: DateRange | null) => any;
     change: (value: DateRange) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: DateRange) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: DateRange | null) => any) | undefined;
     onChange?: ((value: DateRange) => any) | undefined;
 }>, {
+    size: Size;
     disabled: boolean;
     min: string;
     max: string;
@@ -37,5 +41,6 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     containerRef: HTMLDivElement;
     triggerRef: HTMLDivElement;
+    panelRef: HTMLDivElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/components/FormField/UidFormField.vue.d.ts

@@ -23,8 +23,8 @@ declare const __VLS_component: import('vue').DefineComponent<UidFormFieldProps,
     label: string;
     required: boolean;
     disabled: boolean;
-    hint: string;
     error: string;
+    hint: string;
     labelFor: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

package/dist/components/Gauge/UidGauge.vue.d.ts

@@ -20,6 +20,8 @@ export interface UidGaugeProps {
     suffix?: string;
     precision?: number;
     formatValue?: (value: number) => string;
+    /** BCP 47 tag for number formatting; defaults to the active kit locale. */
+    locale?: string;
 }
 declare const _default: import('vue').DefineComponent<UidGaugeProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<UidGaugeProps> & Readonly<{}>, {
     size: number;
@@ -27,6 +29,7 @@ declare const _default: import('vue').DefineComponent<UidGaugeProps, {}, {}, {},
     min: number;
     max: number;
     value: number;
+    locale: string;
     showValue: boolean;
     precision: number;
     tone: GaugeTone;

package/dist/components/Image/UidImage.vue.d.ts

@@ -36,9 +36,9 @@ declare const __VLS_component: import('vue').DefineComponent<UidImageProps, {},
     onError?: ((event: Event) => any) | undefined;
     onLoad?: ((event: Event) => any) | undefined;
 }>, {
+    preview: boolean;
     width: number | string;
     height: number | string;
-    preview: boolean;
     radius: string;
     fit: UidImageFit;
     lazy: boolean;

package/dist/components/Mention/UidMention.vue.d.ts

@@ -29,5 +29,6 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     prefix: string | string[];
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     fieldRef: HTMLTextAreaElement;
+    panelRef: HTMLDivElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/components/Radio/UidRadioGroup.vue.d.ts

@@ -31,8 +31,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
     label: string;
     required: boolean;
     disabled: boolean;
-    hint: string;
     error: string;
+    hint: string;
     name: string;
     direction: "horizontal" | "vertical";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;

package/dist/components/Rating/UidRating.vue.d.ts

@@ -10,6 +10,8 @@ export interface UidRatingProps {
     tone?: RatingTone;
     icon?: unknown;
     label?: string;
+    /** BCP 47 tag for number formatting; defaults to the active kit locale. */
+    locale?: string;
 }
 type __VLS_Props = UidRatingProps;
 type __VLS_PublicProps = {
@@ -27,6 +29,7 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     disabled: boolean;
     max: number;
     readonly: boolean;
+    locale: string;
     tone: RatingTone;
     allowHalf: boolean;
     showLabel: boolean;

package/dist/components/Stat/UidStat.vue.d.ts

@@ -17,6 +17,12 @@ export interface UidStatProps {
     footer?: string;
     /** BCP 47 tag for number formatting; defaults to the active kit locale. */
     locale?: string;
+    /**
+     * Where the trend sits: next to the value, wrapping under it when there is
+     * no room (`inline`, default), or always on its own line under the value
+     * (`below`) — which keeps a row of cards uniform whatever the value length.
+     */
+    trendPlacement?: 'inline' | 'below';
 }
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -43,6 +49,7 @@ declare const __VLS_component: import('vue').DefineComponent<UidStatProps, {}, {
     precision: number;
     tone: StatTone;
     trendSuffix: string;
+    trendPlacement: "inline" | "below";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

package/dist/components/Switch/UidSwitch.vue.d.ts

@@ -24,8 +24,8 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     label: string;
     required: boolean;
     disabled: boolean;
-    hint: string;
     error: string;
+    hint: string;
     name: string;
     id: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;

package/dist/components/Table/UidTable.vue.d.ts

@@ -51,12 +51,12 @@ declare const __VLS_component: import('vue').DefineComponent<UidTableProps, {},
     "update:sortKey": (key: string | null) => any;
     "update:sortDirection": (dir: SortDirection) => any;
     "update:selection": (selection: Set<string | number>) => any;
-    "row-click": (row: Record<string, unknown>) => any;
+    "row-click": (row: Record<string, unknown>, event: MouseEvent) => any;
 }, string, import('vue').PublicProps, Readonly<UidTableProps> & Readonly<{
     "onUpdate:sortKey"?: ((key: string | null) => any) | undefined;
     "onUpdate:sortDirection"?: ((dir: SortDirection) => any) | undefined;
     "onUpdate:selection"?: ((selection: Set<string | number>) => any) | undefined;
-    "onRow-click"?: ((row: Record<string, unknown>) => any) | undefined;
+    "onRow-click"?: ((row: Record<string, unknown>, event: MouseEvent) => any) | undefined;
 }>, {
     loading: boolean;
     sortKey: string | null;

package/dist/components/Textarea/UidTextarea.vue.d.ts

@@ -36,10 +36,10 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {
     label: string;
     required: boolean;
     disabled: boolean;
+    error: string;
     placeholder: string;
     readonly: boolean;
     hint: string;
-    error: string;
     name: string;
     rules: RuleInput;
     id: string;

package/dist/components/TimePicker/UidTimePicker.vue.d.ts

@@ -1,4 +1,7 @@
+import { Size } from '../../types/index.js';
 export interface UidTimePickerProps {
+    /** Control height of the shared size scale (`--uid-size-sm|md|lg`). */
+    size?: Size;
     step?: number;
     withSeconds?: boolean;
     hour12?: boolean;
@@ -17,6 +20,7 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     "onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
     onChange?: ((value: string | null) => any) | undefined;
 }>, {
+    size: Size;
     disabled: boolean;
     step: number;
     clearable: boolean;
@@ -25,6 +29,7 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     containerRef: HTMLDivElement;
     triggerRef: HTMLDivElement;
+    panelRef: HTMLDivElement;
     hourColRef: HTMLDivElement;
     minuteColRef: HTMLDivElement;
     secondColRef: HTMLDivElement;

package/dist/components/TreeSelect/UidTreeSelect.vue.d.ts

@@ -1,5 +1,8 @@
+import { Size } from '../../types/index.js';
 import { TreeNode, TreeKey } from '../TreeView/context.js';
 export interface UidTreeSelectProps {
+    /** Control height of the shared size scale (`--uid-size-sm|md|lg`). */
+    size?: Size;
     nodes: TreeNode[];
     multiple?: boolean;
     checkable?: boolean;
@@ -29,6 +32,7 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     onChange?: ((value: TreeKey | TreeKey[] | null) => any) | undefined;
     "onUpdate:expandedKeys"?: ((value: TreeKey[]) => any) | undefined;
 }>, {
+    size: Size;
     required: boolean;
     disabled: boolean;
     multiple: boolean;
@@ -41,5 +45,6 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     containerRef: HTMLDivElement;
     triggerRef: HTMLDivElement;
+    panelRef: HTMLDivElement;
 }, HTMLDivElement>;
 export default _default;

package/dist/composables/useFloatingPanel.d.ts

@@ -0,0 +1,31 @@
+import { MaybeRef, Ref } from 'vue';
+import { Placement } from './usePopover.js';
+export interface UseFloatingPanelOptions {
+    placement?: MaybeRef<Placement>;
+    offset?: number;
+    /**
+     * Give the panel at least the anchor's width (`'min'`) or exactly it
+     * (`'exact'`), as a select-like dropdown does.
+     */
+    matchWidth?: false | 'min' | 'exact';
+}
+/**
+ * A dropdown panel that lives in `<Teleport to="body">` and is positioned
+ * `fixed` against its anchor.
+ *
+ * Rendered in place, a panel is clipped by any ancestor with `overflow` —
+ * a modal's body, a drawer, a card — and stacks inside that ancestor's
+ * stacking context, under a modal's footer. Teleported, it escapes both;
+ * `--uid-z-popover` puts it above modals and drawers.
+ *
+ * While open it follows the anchor on scroll (of any ancestor) and resize,
+ * re-measures when its own content changes size, and flips above the anchor
+ * when there is no room below. It stays transparent until the first measurement,
+ * so it never flashes in the corner of the viewport.
+ */
+export declare function useFloatingPanel(anchorRef: Ref<HTMLElement | null>, panelRef: Ref<HTMLElement | null>, isOpen: Ref<boolean>, options?: UseFloatingPanelOptions): {
+    panelStyle: import('vue').ComputedRef<Record<string, string>>;
+    actualPlacement: Ref<Placement, Placement>;
+    update: () => void;
+    containsTarget: (target: EventTarget | null) => boolean;
+};

package/dist/composables/useOverlayStack.d.ts

@@ -0,0 +1,5 @@
+export declare function useOverlayStack(): {
+    push: () => void;
+    pop: () => void;
+    isTop: () => boolean;
+};