@kazee-ds/vue 0.11.0 → 0.12.0

package/dist/types/Combobox.vue.d.ts

@@ -1,5 +1,6 @@
 import { type StylingProps } from './styling.js';
 import type { SelectSize, SelectVariant } from './types.js';
+import { type PopoverAlign, type PopoverPositionProps, type PopoverWidth } from './popover-position.js';
 import { type SelectOption } from './selection-options.js';
 type __VLS_Props = StylingProps<'check' | 'clear' | 'closeIcon' | 'control' | 'description' | 'empty' | 'error' | 'icon' | 'input' | 'item' | 'itemLabel' | 'label' | 'leading' | 'list' | 'popover' | 'required' | 'root' | 'toggle'> & {
     label: string;
@@ -8,6 +9,12 @@ type __VLS_Props = StylingProps<'check' | 'clear' | 'closeIcon' | 'control' | 'd
     hideLabel?: boolean;
     fullWidth?: boolean;
     maxHeight?: number;
+    /** Trigger edge the popover aligns to. Defaults to `start`. */
+    popoverAlign?: PopoverAlign;
+    /** `trigger` (default) matches the input group; `content` grows with the options. */
+    popoverWidth?: PopoverWidth;
+    /** Reka UI positioning passthrough; `align` here wins over `popoverAlign`. */
+    popoverProps?: PopoverPositionProps;
     menuTrigger?: 'input' | 'focus' | 'manual';
     selectOnFocus?: boolean;
     disallowEmptySelection?: boolean;
@@ -50,7 +57,10 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     defaultValue: string;
     emptyMessage: string;
     errorMessage: string;
+    popoverAlign: PopoverAlign;
+    popoverProps: PopoverPositionProps;
     maxHeight: number;
+    popoverWidth: PopoverWidth;
     menuTrigger: "input" | "focus" | "manual";
     requiredMessage: string;
     clearLabel: string;

package/dist/types/DateRangePicker.vue.d.ts

@@ -1,6 +1,7 @@
 import { type StylingProps } from './styling.js';
 import { type DateRange, type DateRangeOptions } from './date-range-model.js';
-interface Props extends DateRangeOptions {
+import { type PopoverPositionOptions } from './popover-position.js';
+interface Props extends DateRangeOptions, PopoverPositionOptions {
     modelValue?: DateRange | null;
     disabled?: boolean;
     readonly?: boolean;

package/dist/types/Select.vue.d.ts

@@ -1,11 +1,18 @@
 import { type StylingProps } from './styling.js';
 import { type SelectOption } from './selection-options.js';
 import type { SelectSize, SelectVariant } from './types.js';
+import { type PopoverAlign, type PopoverPositionProps, type PopoverWidth } from './popover-position.js';
 declare const __VLS_export: <M extends "single" | "multiple" = "single">(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: import("vue").PublicProps & __VLS_PrettifyLocal<(StylingProps<"root" | "error" | "description" | "label" | "required" | "list" | "value" | "clear" | "item" | "check" | "control" | "closeIcon" | "icon" | "itemLabel" | "leading" | "popover" | "trigger"> & {
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<(StylingProps<"root" | "error" | "description" | "label" | "required" | "list" | "value" | "clear" | "item" | "check" | "control" | "trigger" | "closeIcon" | "icon" | "itemLabel" | "leading" | "popover"> & {
         label: string;
         options: SelectOption[];
         maxHeight?: number;
+        /** Trigger edge the popover aligns to. Defaults to `start`. */
+        popoverAlign?: PopoverAlign;
+        /** `content` (default) grows with the options; `trigger` matches the trigger and wraps them. */
+        popoverWidth?: PopoverWidth;
+        /** Reka UI positioning passthrough; `align` here wins over `popoverAlign`. */
+        popoverProps?: PopoverPositionProps;
         size?: SelectSize;
         variant?: SelectVariant;
         hideLabel?: boolean;

package/dist/types/TemporalPicker.vue.d.ts

@@ -34,6 +34,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     range: boolean;
     visibleMonths: 1 | 2;
     weekStartsOn: 0 | 1;
+    open: boolean;
     defaultOpen: boolean;
     display: "dialog" | "inline" | "auto" | "popover";
     commitMode: "immediate" | "apply";

package/dist/types/index.d.ts

@@ -34,6 +34,7 @@ export declare const Input: typeof InputCompact & {
     ClearButton: typeof Parts.InputClearButton;
 };
 export type { ButtonSize, ButtonVariant, SelectOption, InputSize, InputType } from './types.js';
+export type { PopoverAlign, PopoverWidth, PopoverPositionProps, PopoverPositionOptions, } from './popover-position.js';
 export type { InputVariant, InputMode, InputEnterKeyHint } from './types.js';
 import TextareaCompact from './Textarea.vue.js';
 export declare const Textarea: typeof TextareaCompact & {

package/dist/types/popover-position.d.ts

@@ -0,0 +1,22 @@
+/** Logical trigger edge the popover aligns to; `end` is the left edge in RTL. */
+export type PopoverAlign = 'start' | 'center' | 'end';
+/** `trigger` matches the trigger width and wraps long options; `content` grows with its options. */
+export type PopoverWidth = 'trigger' | 'content';
+/** Reka UI positioning options forwarded to the popover content. */
+export interface PopoverPositionProps {
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    align?: PopoverAlign;
+    sideOffset?: number;
+    alignOffset?: number;
+    avoidCollisions?: boolean;
+    collisionPadding?: number | Partial<Record<'top' | 'right' | 'bottom' | 'left', number>>;
+}
+export interface PopoverPositionOptions {
+    /** Trigger edge the popover aligns to. Defaults to `start`. */
+    popoverAlign?: PopoverAlign;
+    /** Positioning passthrough; `align` here wins over `popoverAlign`. */
+    popoverProps?: PopoverPositionProps;
+}
+/** Merge defaults, the alignment shortcut and the passthrough, ignoring undefined passthrough keys. */
+export declare function popoverPosition({ popoverAlign, popoverProps }: PopoverPositionOptions, defaults?: PopoverPositionProps): PopoverPositionProps;
+export declare function popoverWidthClass(width: PopoverWidth): string;

package/dist/types/temporal-parts.d.ts

@@ -41,6 +41,7 @@ export declare const TemporalPickerTrigger: import("vue").DefineComponent<{}, ()
 export declare const TemporalPickerContent: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** Position attributes set on this part win over the picker's `popoverAlign` / `popoverProps`. */
 export declare const TemporalPickerPopover: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/types/temporal-types.d.ts

@@ -1,4 +1,5 @@
 import type { TemporalConstraints, TemporalKind, TemporalRange } from './temporal-model.js';
+import type { PopoverPositionOptions } from './popover-position.js';
 import type { HTMLAttributes } from 'vue';
 export type TemporalNativeAttributes = Pick<HTMLAttributes, 'class' | 'style' | 'id' | 'role' | 'aria-label' | 'aria-labelledby' | 'aria-describedby'>;
 export type TemporalValue = string | TemporalRange;
@@ -7,7 +8,7 @@ export interface TemporalPreset<T = TemporalValue> {
     label: string;
     value: T | null;
 }
-export interface TemporalOptions extends Omit<TemporalConstraints, 'kind'> {
+export interface TemporalOptions extends Omit<TemporalConstraints, 'kind'>, PopoverPositionOptions {
     label: string;
     locale?: string;
     dir?: 'ltr' | 'rtl';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kazee-ds/vue",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "exports": {
     ".": {